Référence API

Anciennes API et compatibilité

#Compatibilité OpenAI

Chaque chemin accepte le corps de requête OpenAI — les paramètres propres aux fournisseurs (anthropic tool_use, gemini thinking_config) sont transmis tels quels.

Même enveloppe de réponse qu'OpenAI

Le corps de la réponse correspond exactement à celui d'OpenAI : les parseurs, la logique de nouvelle tentative et les wrappers d'observabilité écrits pour OpenAI continuent de fonctionner.

Les endpoints de cette page sont actifs et facturés comme les autres, mais ce n'est pas la méthode d'intégration recommandée. Utilisez-les lorsqu'un SDK fournisseur existant doit continuer à fonctionner sans modification, ou lorsque vous avez hérité d'un appel que vous n'êtes pas prêt à migrer.

#Quelle interface utiliser ?

Nouvelle intégration

Utilisez les endpoints /v1 au format OpenAI de la référence API. Un même vocabulaire pour toutes les capacités, et la seule interface qui reçoit de nouveaux paramètres.

SDK fournisseur existant

Utilisez la transmission directe correspondante ci-dessous. Vous changez l'URL de base et la clé, et conservez le corps de requête propre au fournisseur.

Appel historique hérité

Il continue de fonctionner. Migrez la prochaine fois que vous touchez à ce code — ces routes sont figées, pas maintenues.

#Transmission directe native du fournisseur

Ces routes acceptent le corps de requête propre au fournisseur et renvoient son format de réponse. L'authentification reste un unique en-tête Authorization: Bearer avec une clé de cette plateforme — le schéma d'authentification du fournisseur n'est pas utilisé.

Gemini natif

transmission directe

Pointez le SDK Google GenAI vers cette passerelle sans modifier le code. Le format du chemin generateContent et le corps de la requête sont ceux de Gemini.

GET	/v1beta/models	Liste les modèles au format du catalogue Gemini.
POST	/v1beta/models/*	Format de chemin Gemini : /v1beta/models/{model}:{action}, par ex. :generateContent ou :streamGenerateContent.
POST	/v1/models/*	Même format de requête Gemini sous /v1, pour les clients qui ne peuvent pas changer le préfixe de version de l'API.
POST	/v1/engines/:model/embeddings	Embeddings Gemini via l'ancien chemin engines.

Kling natif

transmission directe

Accepte le corps de requête officiel de Kling (model_name + prompt et les champs propres au fournisseur) et renvoie son format de tâche.

POST	/kling/v1/videos/text2video	Soumet une tâche Kling texte vers vidéo au format de corps du fournisseur.
POST	/kling/v1/videos/image2video	Soumet une tâche Kling image vers vidéo.
GET	/kling/v1/videos/text2video/:task_id	Interroge une tâche Kling texte vers vidéo.
GET	/kling/v1/videos/image2video/:task_id	Interroge une tâche Kling image vers vidéo.

Jimeng natif

transmission directe

API officielle de Jimeng, de type Action-query. La soumission et le résultat partagent un même chemin et se distinguent par le paramètre Action.

POST	/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31	Soumet une tâche avec req_key et prompt dans le corps du fournisseur. La barre oblique finale est obligatoire — /jimeng redirige, et un 301 fait perdre le corps dans la plupart des clients HTTP.
POST	/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31	Récupère le résultat d'une tâche soumise.

Suno natif

transmission directe

Soumission et récupération de musique au format Suno. Préférez /v1/music/generations pour les nouveaux développements — il renvoie le format de tâche de la plateforme utilisé partout ailleurs.

POST	/suno/submit/:action	action vaut music ou lyrics.
POST	/suno/fetch	Récupération groupée par liste d'id.
GET	/suno/fetch/:id	Récupère une tâche.

gemini-native.sh

# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

Les réponses transmises directement sont celles du fournisseur, pas les nôtres

Les codes de statut, corps d'erreur et noms de champs de ces routes suivent le fournisseur en amont. L'enveloppe d'erreur de la plateforme et les codes d'erreur documentés ne s'appliquent qu'aux rejets côté passerelle, comme l'authentification, le quota et le routage.

#Routes historiques figées

Routées et facturées, mais fermées aux évolutions : aucun nouveau paramètre, aucun nouveau modèle garanti, et aucune promesse de compatibilité au-delà de ce qui fonctionne aujourd'hui.

Alias historiques

figé

Toujours routés, toujours facturés, mais figés : aucun nouveau paramètre et aucune garantie de compatibilité. Migrez dès que vous modifiez le code appelant.

POST	/v1/completions	Ancienne complétion de prompt OpenAI. Utilisez /v1/chat/completions.
POST	/v1/edits	Route vers le format de retouche d'image malgré son nom. Utilisez /v1/images/edits.
POST	/v1/video/generations	Soumission vidéo antérieure au format OpenAI. Utilisez POST /v1/videos.
GET	/v1/video/generations/:task_id	Interrogation vidéo antérieure au format OpenAI. Utilisez GET /v1/videos/{task_id}.

Archive Midjourney

figé

Lecture seule. La soumission payante Midjourney est retirée ; seule la consultation des tâches historiques et de leurs images archivées reste possible.

GET	/mj/task/:id/fetch	Consulte une tâche archivée.
GET	/mj/task/:id/image-seed	Lit la seed d'une image archivée.
GET	/mj/image/:id	Renvoie une image archivée.

#Ce qui renvoie 404

Les interfaces OpenAI non prises en charge ne sont pas enregistrées du tout. Un 404 sur un chemin OpenAI signifie que la capacité n'est réellement pas servie ici — ce n'est pas une lacune temporaire, et aucune route ne répond 501 pour faire illusion.

Découvrir ce qu'une clé peut réellement atteindre

GET /v1/models liste tous les modèles que cette clé peut appeler. En le combinant avec un 404 sur le chemin lui-même, vous pouvez distinguer « modèle non autorisé » d'« endpoint non servi ».

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.

PrécédentFacturation et solde SuivantAvant la mise en production