Commencez
Quel point de terminaison appeler
URL de base, choix de l'hôte et à quelle famille d'API envoyer chaque requête.
Modelflare utilise une clé API sur plusieurs protocoles. L’enveloppe JSON n’est pas la même pour tous les modèles. Choisissez d’abord la famille, puis copiez la demande à partir du guide de correspondance ou de la page modèle.
URL de base
Section intitulée « URL de base »https://modelflare.dev/v1Le trafic EdgeOne orienté vers la Chine peut utiliser https://origin.modelflare.dev/v1 pour la même application. Choisissez l’hébergeur avant d’envoyer une demande ; ne redirigez pas un POST en vol entre les hôtes.
Les clients Anthropic constituent l’exception : ANTHROPIC_BASE_URL est https://modelflare.dev (l’origine du site, pas /v1). La CLI officielle Claude Code ajoute le chemin des messages lui-même. Voir Claude Code.
Authentification
Section intitulée « Authentification »Authorization: Bearer YOUR_MODELFLARE_API_KEYEnvoyez cet en-tête à chaque demande, y compris les interrogations vidéo et les téléchargements. Créez la clé dans la console. Détails : Authentification.
Familles
Section intitulée « Familles »https://modelflare.devChat Completions
POST /v1/chat/completions Chat compatible OpenAI.
Responses
POST /v1/responses Codex et Grok Build.
Anthropic Messages
ANTHROPIC_BASE_URL=https://modelflare.dev La CLI Claude Code ajoute le chemin des messages lui-même.
Images
POST /v1/images/generations Images GPT, image Wan et Seedream.
Gemini natif
POST /v1/models/{model}:generateContent Modèles d'images Gemini. Gemini CLI utilise l'orthographe /v1beta elle-même.
Vidéo
POST /v1/videos Crée une tâche : interrogez-la, puis téléchargez le résultat.
Seedance actifs
POST /volc/asset/* Gérez les groupes d'actifs Seedance et les identifiants de médias côté fournisseur.
Modèles
GET /v1/models Ce que la clé actuelle peut appeler.
| Famille | Entrée typique | Utilisez-le pour |
|---|---|---|
| Chat Completions | POST /v1/chat/completions |
Chat compatible OpenAI. Première requête : Quickstart. |
| Responses | POST /v1/responses |
Codex et Grok Build. |
| Anthropic Messages | Anthropic | Claude Code. |
| Images | POST /v1/images/generations |
Images GPT, image Wan et Seedream. Champs exacts : modèles d’image. |
| Gemini natif | POST /v1/models/{model}:generateContent |
Gemini ; également servi sur origin.modelflare.dev. Gemini CLI construit le même chemin sous /v1beta, que seul modelflare.dev dessert. |
| Vidéo | POST /v1/videos |
Seedance, Wan, Kling et autres modèles vidéo asynchrones. Sondez GET /v1/videos/{task_id} et téléchargez GET /v1/videos/{task_id}/content. Enveloppe exacte : modèles vidéo. |
| Seedance actifs | POST /volc/asset/* |
Créer, interroger, mettre à jour et supprimer des groupes d’actifs et des médias côté fournisseur. Voir Gestion des actifs Seedance. |
| Modèles | GET /v1/models |
Liste les modèles que la clé actuelle peut appeler. |
Les demandes d’images et de vidéos de point de terminaison erronées sont rejetées avec unsupported_endpoint. N’envoyez pas les champs d’image Gemini vers /v1/images/* ou les champs d’images GPT vers generateContent. Ne mélangez pas les champs Chat Completions dans un client Responses ou Anthropic.
L’image et la vidéo fonctionnent avec une Smart API Key ou une clé API de groupe media. Les URL de résultats peuvent expirer ; transférer le fichier après la réussite d’une tâche vidéo.
Les appels de gestion d’actifs Seedance acceptent les mêmes clés : une clé API intelligente ou une clé API de groupe media. La création d’actifs est asynchrone ; utilisez GetAsset jusqu’à Active, puis transmettez le asset://<ID> renvoyé inchangé dans une requête Seedance prise en charge. La passerelle conserve la propriété des actifs par utilisateur et n’ajoute pas de frais de gestion des ressources distincts.
Liste des modèles pour cette clé
Section intitulée « Liste des modèles pour cette clé »https://modelflare.dev/v1/modelscurl https://modelflare.dev/v1/models \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"La réponse répertorie les modèles que la clé actuelle peut appeler. Il ne remplace pas Modèles et tarification, qui inclut les prix, les groupes et les étiquettes de protocole. Utilisez le id exact dans le champ JSON model. Voir Modèles et groupes.