YITOKEN YITOKENTài liệu API

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-lite0.45¥0.45
seedream-5.0-pro0.9¥0.90

Tạo video · tính theo token

Mô hìnhHệ số≈ CNY / 1 triệu token
doubao-seedance-2.036.225¥72.5
doubao-seedance-2.0-480p-1080p23¥46.0
doubao-seedance-2.0-480p-720p23¥46.0
doubao-seedance-2.0-720p-1080p23¥46.0
doubao-seedance-2.0-fast27.75¥55.5
doubao-seedance-2.0-fast-480p-1080p18.5¥37.0
doubao-seedance-2.0-fast-480p-720p18.5¥37.0
doubao-seedance-2.0-fast-720p-1080p18.5¥37.0
doubao-seedance-2.0-mini17.25¥34.5
doubao-seedance-2.0-mini-480p-1080p11.5¥23.0
doubao-seedance-2.0-mini-480p-720p11.5¥23.0
doubao-seedance-2.0-mini-720p-1080p11.5¥23.0
seedance-2.025.5¥51.0
seedance-2.0-fast18.5¥37.0
seedance-2.0-mini11.5¥23.0
seedance-2.535¥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ìnhNhómĐầu vàoĐầu raĐọc bộ nhớ đệmGhi bộ nhớ đệm
gpt-6.1-solGPT 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 choCách tính
Theo lượtTạo ảnhTrừ một mức cố định mỗi lần gọi, không phụ thuộc độ dài prompt
Theo tokenTạo videohạ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ẫnMục đích
POST /v1/images/generationsTạo ảnh
POST /v1/video/generationsGử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/completionsTrò chuyện văn bản (GPT-6.1 Sol)
POST /v1/responsesAPI Responses, dùng cho các client như Codex CLI
GET /v1/modelsLiệt kê các mô hình khả dụng
GET /v1/dashboard/billing/usageTra 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ĩaCách xử lý
401 Invalid tokenKhóa API không hợp lệ hoặc đã bị xóaKiểm tra Authorization: Bearer sk-..., chú ý không được thiếu tiền tố sk-
model_not_foundSai tên mô hình, hoặc mô hình chưa mở cho nhóm của bạnDùng /v1/models để xác nhận tên mô hình khả dụng
insufficient_quotaSố dư không đủ, hoặc không đủ cho khoản tạm trừ của tác vụ videoNạp tiền rồi thử lại
403Khóa API bị vô hiệu hóa hoặc vượt giới hạnKiể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.