Bắt đầu nhanh

Guide này đưa bạn từ một tenant mới tới response đầu tiên từ Platform model. Model và catalog endpoint đã được OneNexus vận hành, nên flow này không cần GPU quota.

Trước khi bắt đầu

Bạn cần:

quyền truy cập OneNexus Console với một tenant đã được phê duyệt. Nếu bạn chưa có, hãy đăng ký pilot access;
Python 3 và pip; và
quyền tạo API key.

Gửi request đầu tiên

Chọn một Platform model.

Trong Console, mở Mô hình nền tảng (Platform models) và mở rộng một dòng model. Copy hai giá trị:
- Endpoint dùng chung hiển thị phía trên catalog; và
- giá trị model chính xác trong Lệnh gọi cURL (cURL request) của dòng đó.
Dùng giá trị trong generated cURL, không dùng cột ID mô hình công khai (Public model ID). Cột đó là catalog/billing identity; serving router dispatch theo string model trong cURL request.

Nếu dòng hiển thị cảnh báo màu vàng rằng policy layer chưa xác nhận listing, hãy đợi cảnh báo biến mất hoặc chọn model khác — một listing vừa publish có thể mất khoảng một phút để gọi được.

endpoint phía trên bảng, và giá trị model trong cURL của dòng đã mở — dùng hai giá trị đó, không dùng cột Public model ID.
Tạo Platform API key.

Mở Khóa API → Tạo khóa API. Chọn thời hạn, sau đó đặt Loại thành Platform.

Copy secret trong success dialog; Console chỉ hiển thị secret một lần.

Platform key không hiện danh sách model — nó gọi toàn bộ catalog và không thể thu hẹp scope.

Đặt các giá trị kết nối.

Thay <model-value-from-curl> bằng giá trị model đã copy ở bước 1. URL bên dưới là catalog URL thông thường; nếu Console hiển thị endpoint khác, hãy dùng giá trị trong Console.

Bash hoặc zsh

export ONX_BASE_URL="https://catalog.onenexus-do.cloud/v1"
export ONX_MODEL="<model-value-from-curl>"

Chạy riêng key prompt bên dưới, rồi paste key khi được hỏi, để không ghi secret vào shell history.

printf "OneNexus Platform API key: "; IFS= read -rs ONX_API_KEY </dev/tty && export ONX_API_KEY && printf "\n"

PowerShell

$env:ONX_BASE_URL = "https://catalog.onenexus-do.cloud/v1"
$env:ONX_MODEL = "<model-value-from-curl>"
$secret = Read-Host "OneNexus Platform API key" -AsSecureString
$env:ONX_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password
Remove-Variable secret

Cài SDK và tạo script.

Cài OpenAI Python SDK:

python -m pip install openai

Lưu đoạn sau thành first_call.py:

import os

from openai import OpenAI

client = OpenAI(
    base_url=os.environ["ONX_BASE_URL"],
    api_key=os.environ["ONX_API_KEY"],
)

response = client.chat.completions.create(
    model=os.environ["ONX_MODEL"],
    messages=[{"role": "user", "content": "Hãy chào bằng một câu."}],
)

print("Success:", response.choices[0].message.content)

Chạy request và kiểm tra response.
Terminal
```
python first_call.py
```
Khi thành công, terminal in ra message do model tạo với prefix Success:. Ví dụ:
```
Success: Xin chào! Chúc bạn một ngày tốt lành.
```
Nội dung sau Success: có thể khác nhau; final-answer result hoàn chỉnh có response.choices[0].message.content. Response 2xx không có final text vẫn chứng minh API đã được gọi; hãy kiểm tra full response trước khi retry, vì một số model có thể trả reasoning mà không có final content.

Nếu request đầu tiên lỗi

Kết quả	Cần kiểm tra
`401`	`Authorization` header đã nhận key hay chưa. Nếu mất secret, hãy tạo key thay thế.
`403`	Key có Loại Platform, catalog endpoint chính xác, request dùng đúng giá trị `model` trong cURL request của dòng và không còn warning từ policy layer. Không retry nguyên trạng.
`404`	URL kết thúc bằng `/v1/chat/completions`. Catalog hiện chưa cung cấp `GET /v1/models`.
`429` hoặc `503`	Chỉ retry số lần hữu hạn với exponential backoff và jitter. Escalate nếu lỗi kéo dài.

Không log API key hoặc đưa key vào source code. Xem Tham chiếu API để biết request contract và cách xử lý lỗi đầy đủ.

Bước tiếp theo

Trước
Tổng quan Tiếp
Tham chiếu API