Bắt đầu nhanh và hướng dẫn tích hợp API

Dùng một khóa API cho văn bản, ảnh và video. Ví dụ dưới đây dùng trang này làm địa chỉ API.

Tạo Khóa API Xem mô hình và giá

Xác thực và chọn mô hình

Tạo và lưu khóa trong bảng điều khiển, rồi gửi qua tiêu đề Authorization: Bearer. Lưu khóa ở phía máy chủ.

Thay MODEL_ID bằng ID mô hình đã công bố. Giao thức, thời lượng, độ phân giải và giá tùy theo mô hình.

OpenAI SDK

base_url = "https://www.lvzhouai.cc/v1"

Văn bản

POST /v1/chat/completions

bash

curl 'https://www.lvzhouai.cc/v1/chat/completions' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-6-luna",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "max_tokens": 64
}'

Hình ảnh

POST /v1/images/tasks

bash

curl 'https://www.lvzhouai.cc/v1/images/tasks' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "A blue ceramic cup on a wooden table",
  "resolution": "1K"
}'

Video

POST /v1/videos/tasks

bash

curl 'https://www.lvzhouai.cc/v1/videos/tasks' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A slow camera movement through a garden",
  "resolution": "480p",
  "duration": 8
}'

Bắt đầu với Python và Node.js

Đặt API_STATION_KEY trong biến môi trường của máy chủ. Các ví dụ này dùng cùng endpoint văn bản với curl.

Python 3

import json, os
from urllib.request import Request, urlopen

request = Request(
    "https://www.lvzhouai.cc/v1/chat/completions",
    data=json.dumps({"model": "gpt-6-luna", "messages": [{"role": "user", "content": "Hello"}], "max_tokens": 64}).encode(),
    headers={"Authorization": "Bearer " + os.environ["API_STATION_KEY"], "Content-Type": "application/json"},
)
with urlopen(request, timeout=60) as response:
    print(json.load(response)["choices"][0]["message"]["content"])

Node.js 20+

const response = await fetch("https://www.lvzhouai.cc/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.API_STATION_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-6-luna",
    messages: [{ role: "user", content: "Hello" }],
    max_tokens: 64,
  }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.message || "Request failed");
console.log(result.choices[0].message.content);

Mô hình, thông số và đơn vị tính phí

Giá văn bản được hiển thị cho mỗi triệu token đầu vào hoặc đầu ra. Hình ảnh tính phí theo ảnh, video theo số giây được tạo. Mức giá tùy thuộc mô hình và thông số; hãy xem bảng giá hiện tại trước khi gửi.

Ví dụ dùng thông số đã công bố: gpt-image-2 ở 1K và grok-imagine-video-1.5 ở 480p trong 8 giây. Không mặc định rằng kích thước, thời lượng, công cụ hoặc đầu vào đa phương tiện khác được hỗ trợ.

Dùng GET /v1/models để xem các mô hình mà khóa của bạn có thể truy cập. Danh mục công khai hiển thị thông số và giá; quyền của khóa có thể giới hạn danh sách khả dụng.

bash

curl 'https://www.lvzhouai.cc/v1/models' \
  -H "Authorization: Bearer YOUR_API_KEY"

Khi tạo tác vụ đa phương tiện, API trả HTTP 201 cùng id, state và billing_state. Thăm dò GET /v1/tasks/{id} bằng cùng khóa API. succeeded là kết quả tạo nội dung, settled là kết quả tính phí riêng. Nếu chưa rõ việc gửi đã thành công hay chưa, giữ nguyên Idempotency-Key và dữ liệu đầu vào.

Trạng thái và kết quả tác vụ

Mỗi thao tác ảnh hoặc video cần một Idempotency-Key duy nhất dài 16–128 ký tự. Nếu chưa rõ kết quả gửi, thử lại với cùng khóa và dữ liệu đầu vào.

Lưu id trả về khi tạo tác vụ và kiểm tra trạng thái bằng cùng khóa API. Khi state là succeeded, đọc results[].url và kiểm tra riêng billing_state.

GET /v1/tasks/{id}

bash

curl 'https://www.lvzhouai.cc/v1/tasks/TASK_ID' \
  -H "Authorization: Bearer YOUR_API_KEY"

Đọc results[].url và results[].expires_at nếu có. Liên kết chỉ có hiệu lực tạm thời; hãy lưu các tệp cần giữ. Truy vấn lại cùng tác vụ sẽ làm mới liên kết truy cập của trang mà không tạo lại nội dung. Kết quả ở nhà cung cấp vẫn có thể hết hạn.

Xử lý lỗi yêu cầu

401 / 403: Kiểm tra trạng thái khóa API và quyền truy cập mô hình.
400: Kiểm tra ID mô hình và thông số đầu vào được hỗ trợ.
402: Số dư khả dụng không đủ để gửi yêu cầu này.
409: Khi thử lại, dùng Idempotency-Key ban đầu với dữ liệu hoàn toàn giống nhau. Dùng khóa mới cho thao tác khác.
429: Chờ hết khoảng thời gian Retry-After trước khi thử lại.
503: Dịch vụ có thể tạm dừng hoặc chưa được cấu hình. Hãy kiểm tra với quản trị viên.

Giữ lại header phản hồi X-Oneapi-Request-Id khi báo lỗi. Không gửi kèm khóa API, mật khẩu hoặc mã xác minh.

Không tự động thử lại khi luồng văn bản đã bắt đầu. Nếu kết nối gián đoạn, giữ ID yêu cầu và kiểm tra lịch sử sử dụng.

Xem dữ liệu sử dụng