Tài liệu API YITOKEN
Cổng AI hợp nhất · Tương thích hoàn toàn với đặc tả API của OpenAI, mã hiện có chỉ cần đổi base_url.
Bắt đầu nhanh
1
Đăng ký và lấy khóa API
Đăng nhập
yitoken.com.cn → Bảng điều khiển → Khóa API → Tạo, rồi sao chép khóa có dạng
sk-xxxxxx.
2
Trỏ base_url về YITOKEN
Mọi đường dẫn API đều giống OpenAI, chỉ cần đổi tên miền.
3
Gọi lần đầu tiên
Ví dụ dưới đây tạo một ảnh.
curl
curl https://yitoken.com.cn/v1/images/generations \
-H "Authorization: Bearer sk-khoa-api-cua-ban" \
-H "Content-Type: application/json" \
-d '{"model":"seedream-5.0-lite","prompt":"a red bicycle","n":1}'
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-khoa-api-cua-ban",
base_url="https://yitoken.com.cn/v1",
)
resp = client.images.generate(
model="seedream-5.0-lite",
prompt="a red bicycle leaning on a brick wall",
n=1,
)
print(resp.data[0].url)
Node.js
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-khoa-api-cua-ban',
baseURL: 'https://yitoken.com.cn/v1',
});
const r = await client.images.generate({
model: 'seedream-5.0-lite',
prompt: 'a red bicycle',
});
console.log(r.data[0].url);
Mô hình và giá
YITOKEN cung cấp các mô hình tạo video Seedance của ByteDance, các mô hình tạo ảnh Seedream và noimg, cùng mô hình văn bản GPT-6.1 Sol. Danh sách mô hình đầy đủ và giá theo thời gian thực xem tại trang Mô hình và giá. Giá tính bằng nhân dân tệ (CNY).
Tạo ảnh · tính theo lượt
| Mô hình | Đơn giá (đơn vị hạn ngạch) | ≈ CNY / ảnh |
seedream-5.0-lite | 0.45 | ¥0.45 |
seedream-5.0-pro | 0.9 | ¥0.90 |
Tạo video · tính theo token
| Mô hình | Hệ số | ≈ CNY / 1 triệu token |
doubao-seedance-2.0 | 36.225 | ¥72.5 |
doubao-seedance-2.0-480p-1080p | 23 | ¥46.0 |
doubao-seedance-2.0-480p-720p | 23 | ¥46.0 |
doubao-seedance-2.0-720p-1080p | 23 | ¥46.0 |
doubao-seedance-2.0-fast | 27.75 | ¥55.5 |
doubao-seedance-2.0-fast-480p-1080p | 18.5 | ¥37.0 |
doubao-seedance-2.0-fast-480p-720p | 18.5 | ¥37.0 |
doubao-seedance-2.0-fast-720p-1080p | 18.5 | ¥37.0 |
doubao-seedance-2.0-mini | 17.25 | ¥34.5 |
doubao-seedance-2.0-mini-480p-1080p | 11.5 | ¥23.0 |
doubao-seedance-2.0-mini-480p-720p | 11.5 | ¥23.0 |
doubao-seedance-2.0-mini-720p-1080p | 11.5 | ¥23.0 |
seedance-2.0 | 25.5 | ¥51.0 |
seedance-2.0-fast | 18.5 | ¥37.0 |
seedance-2.0-mini | 11.5 | ¥23.0 |
seedance-2.5 | 35 | ¥70.0 |
Video được tính phí theo số token của nội dung tạo ra; số token phụ thuộc vào thời lượng, độ phân giải và tốc độ khung hình.
Một video 5 giây 480p khoảng 50.000 token, một video 15 giây 720p khoảng 300.000 token.
Văn bản · tính theo token
| Mô hình | Nhóm | Đầu vào | Đầu ra | Đọc bộ nhớ đệm | Ghi bộ nhớ đệm |
gpt-6.1-sol | GPT Codex | ¥0.55 | ¥2.75 | ¥0.0275 | ¥0.6875 |
Đơn giá tính trên mỗi 1 triệu token, áp dụng cho ngữ cảnh đến 272K; vượt quá 272K thì mọi đơn giá tăng gấp đôi.
Cách tính phí
Đơn vị hạn ngạch
Số dư tài khoản được tính bằng hạn ngạch: 500.000 hạn ngạch = 1 đơn vị.
Khi nạp tiền, ¥1 = 1 đơn vị.
Hai cách tính phí
| Cách | Áp dụng cho | Cách tính |
| Theo lượt | Tạo ảnh | Trừ một mức cố định mỗi lần gọi, không phụ thuộc độ dài prompt |
| Theo token | Tạo video | hạn ngạch = token × hệ số mô hình |
Tạm trừ và quyết toán
Video là tác vụ bất đồng bộ: khi bắt đầu, hệ thống tạm trừ một khoản theo mức tối đa; khi hoàn thành, quyết toán theo mức dùng thực tế do nhà cung cấp trả về — nếu thấp hơn khoản tạm trừ thì hoàn lại phần chênh lệch, nếu cao hơn thì trừ thêm phần chênh lệch.
Tác vụ thất bại được hoàn lại toàn bộ. Nếu số dư không đủ cho khoản tạm trừ, tác vụ không thể bắt đầu — đây là nguyên nhân thất bại phổ biến nhất.
API
| Đường dẫn | Mục đích |
POST /v1/images/generations | Tạo ảnh |
POST /v1/video/generations | Gửi tác vụ tạo video, trả về task_id |
GET /v1/video/generations/{task_id} | Tra cứu trạng thái tác vụ video |
POST /v1/chat/completions | Trò chuyện văn bản (GPT-6.1 Sol) |
POST /v1/responses | API Responses, dùng cho các client như Codex CLI |
GET /v1/models | Liệt kê các mô hình khả dụng |
GET /v1/dashboard/billing/usage | Tra cứu mức sử dụng |
Ví dụ gọi mô hình văn bản
curl https://yitoken.com.cn/v1/chat/completions \
-H "Authorization: Bearer sk-khoa-api-cua-ban" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"Xin chào"}]}'
Với các client dùng API Responses như Codex CLI, chỉ cần đặt base_url là https://yitoken.com.cn/v1.
Quy trình tạo video đầy đủ
# 1. Gửi tác vụ
curl https://yitoken.com.cn/v1/video/generations \
-H "Authorization: Bearer sk-khoa-api-cua-ban" \
-H "Content-Type: application/json" \
-d '{"model":"seedance-2.0-mini","prompt":"a paper boat on a stream","metadata":{"resolution":"480p"}}'
# → {"task_id":"task_xxx","status":"queued"}
# 2. Truy vấn trạng thái (khoảng 1–3 phút)
curl https://yitoken.com.cn/v1/video/generations/task_xxx \
-H "Authorization: Bearer sk-khoa-api-cua-ban"
Lỗi thường gặp
| Phản hồi | Ý nghĩa | Cách xử lý |
401 Invalid token | Khóa API không hợp lệ hoặc đã bị xóa | Kiểm tra Authorization: Bearer sk-..., chú ý không được thiếu tiền tố sk- |
model_not_found | Sai tên mô hình, hoặc mô hình chưa mở cho nhóm của bạn | Dùng /v1/models để xác nhận tên mô hình khả dụng |
insufficient_quota | Số dư không đủ, hoặc không đủ cho khoản tạm trừ của tác vụ video | Nạp tiền rồi thử lại |
403 | Khóa API bị vô hiệu hóa hoặc vượt giới hạn | Kiểm tra trạng thái và hạn mức của khóa trong bảng điều khiển |
Nạp tiền
Bảng điều khiển → Ví → Nạp tiền, hỗ trợ quét mã thanh toán qua Alipay và WeChat Pay, tiền vào ngay lập tức.