Documentation de l'API YITOKEN
Passerelle d'IA unifiée · Entièrement compatible avec la spécification de l'API OpenAI : votre code existant n'a besoin que d'une nouvelle base_url.
Démarrage rapide
1
S'inscrire et obtenir une clé API
Connectez-vous sur
yitoken.com.cn → Console → Clés API → Créer, puis copiez la clé, de la forme
sk-xxxxxx.
2
Faire pointer base_url vers YITOKEN
Tous les chemins d'API sont identiques à ceux d'OpenAI ; seul le domaine change.
3
Premier appel
L'exemple ci-dessous génère une image.
curl
curl https://yitoken.com.cn/v1/images/generations \
-H "Authorization: Bearer sk-votre-cle-api" \
-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-votre-cle-api",
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-votre-cle-api',
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);
Modèles et tarifs
YITOKEN propose les modèles de génération vidéo Seedance de ByteDance, les modèles de génération d'images Seedream et noimg, ainsi que le modèle de texte GPT-6.1 Sol. La liste complète et les prix en temps réel figurent sur la page Modèles et tarifs. Les prix sont exprimés en yuans chinois (CNY).
Génération d'images · à la requête
| Modèle | Prix (unités de quota) | ≈ CNY par image |
seedream-5.0-lite | 0.45 | ¥0.45 |
seedream-5.0-pro | 0.9 | ¥0.90 |
Génération vidéo · au token
| Modèle | Coefficient | ≈ CNY par million de tokens |
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 |
La vidéo est facturée selon le nombre de tokens du contenu généré, qui dépend de la durée, de la résolution et de la fréquence d'images.
Une vidéo de 5 secondes en 480p représente environ 50 000 tokens ; une vidéo de 15 secondes en 720p, environ 300 000 tokens.
Texte · au token
| Modèle | Groupe | Entrée | Sortie | Lecture du cache | Écriture du cache |
gpt-6.1-sol | GPT Codex | ¥0.55 | ¥2.75 | ¥0.0275 | ¥0.6875 |
Prix par million de tokens, pour un contexte jusqu'à 272K ; au-delà de 272K, tous les prix doublent.
Facturation
Unité de quota
Le solde du compte est exprimé en quota : 500 000 quota = 1 unité.
À la recharge, 1 ¥ = 1 unité.
Deux modes de facturation
| Mode | Pour | Calcul |
| À la requête | Génération d'images | Montant fixe par appel, quelle que soit la longueur du prompt |
| Au token | Génération vidéo | quota = tokens × coefficient du modèle |
Prélèvement préalable et règlement
La vidéo est une tâche asynchrone. Au lancement, un montant calculé sur la limite haute est prélevé à l'avance ; une fois la tâche terminée, le règlement se fait sur la consommation réelle renvoyée par le fournisseur : si elle est inférieure au prélèvement, la différence est remboursée ; si elle est supérieure, la différence est débitée.
Une tâche échouée est intégralement remboursée. Si votre solde ne couvre pas le prélèvement préalable, la tâche ne peut pas démarrer — c'est la cause d'échec la plus fréquente.
API
| Chemin | Usage |
POST /v1/images/generations | Génération d'images |
POST /v1/video/generations | Soumettre une tâche de génération vidéo ; renvoie un task_id |
GET /v1/video/generations/{task_id} | Consulter le statut d'une tâche vidéo |
POST /v1/chat/completions | Conversation texte (GPT-6.1 Sol) |
POST /v1/responses | API Responses, utilisée par des clients comme Codex CLI |
GET /v1/models | Lister les modèles disponibles |
GET /v1/dashboard/billing/usage | Consulter la consommation |
Exemple avec le modèle de texte
curl https://yitoken.com.cn/v1/chat/completions \
-H "Authorization: Bearer sk-votre-cle-api" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"Bonjour"}]}'
Pour les clients qui utilisent l'API Responses, comme Codex CLI, il suffit de définir base_url sur https://yitoken.com.cn/v1.
Déroulé complet d'une génération vidéo
# 1. Soumettre la tâche
curl https://yitoken.com.cn/v1/video/generations \
-H "Authorization: Bearer sk-votre-cle-api" \
-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. Interroger le statut (environ 1 à 3 minutes)
curl https://yitoken.com.cn/v1/video/generations/task_xxx \
-H "Authorization: Bearer sk-votre-cle-api"
Erreurs courantes
| Réponse | Signification | Que faire |
401 Invalid token | Clé API invalide ou supprimée | Vérifiez Authorization: Bearer sk-... et n'oubliez pas le préfixe sk- |
model_not_found | Nom de modèle erroné, ou modèle non ouvert à votre groupe | Appelez /v1/models pour vérifier les noms de modèles disponibles |
insufficient_quota | Solde insuffisant, ou insuffisant pour couvrir le prélèvement préalable d'une tâche vidéo | Rechargez puis réessayez |
403 | Clé API désactivée ou limites dépassées | Vérifiez l'état de la clé et son plafond de crédit dans la console |
Recharge
Console → Portefeuille → Recharger. Paiement par QR code avec Alipay ou WeChat Pay ; le crédit arrive instantanément.