Empezar
Qué endpoint llamar
URL base, elección de host y a qué familia de API enviar cada solicitud.
Modelflare utiliza una clave API en varios protocolos. La envolvente JSON no es la misma para todos los modelos. Elija primero la familia y luego copie la solicitud de la guía de correspondencia o de la página del modelo.
URL base
Sección titulada «URL base»https://modelflare.dev/v1El tráfico EdgeOne orientado a China puede utilizar https://origin.modelflare.dev/v1 para la misma aplicación. Elija el anfitrión antes de enviar una solicitud; no redirija una POST en vuelo entre hosts.
Anthropic son la excepción: ANTHROPIC_BASE_URL es https://modelflare.dev (el origen del sitio, no /v1). La CLI oficial Claude Code agrega la ruta de Mensajes. Consulte Claude Code.
Autenticación
Sección titulada «Autenticación»Authorization: Bearer YOUR_MODELFLARE_API_KEYEnvíe este encabezado en cada solicitud, incluidas las encuestas de video y las descargas. Cree la clave en la consola. Detalles: Autenticación.
Familias
Sección titulada «Familias»https://modelflare.devChat Completions
POST /v1/chat/completions Chat compatible con OpenAI.
Responses
POST /v1/responses Codex y Grok Build.
Anthropic Messages
ANTHROPIC_BASE_URL=https://modelflare.dev La CLI de Claude Code agrega la ruta de Mensajes.
Imágenes
POST /v1/images/generations Imágenes GPT, Imagen Wan y Seedream.
Gemini nativo
POST /v1/models/{model}:generateContent Gemini modelos de imagen. Gemini CLI utiliza la ortografía /v1beta.
Vídeo
POST /v1/videos Crea una tarea: sondea y luego descarga el resultado.
Seedance activos
POST /volc/asset/* Administre grupos de activos de Seedance e ID de medios del lado del proveedor.
Modelos
GET /v1/models Cómo puede llamar la clave actual.
| Familia | Entrada típica | Úselo para |
|---|---|---|
| Chat Completions | POST /v1/chat/completions |
Chat compatible con OpenAI. Primera solicitud: Inicio rápido. |
| Responses | POST /v1/responses |
Codex y Grok Build. |
| Anthropic Messages | Mensajes compatibles con Anthropic | Claude Code. |
| Imágenes | POST /v1/images/generations |
Imágenes GPT, Imagen Wan y Seedream. Campos exactos: modelos de imagen. |
| Gemini nativo | POST /v1/models/{model}:generateContent |
Gemini modelos de imagen; también sirvió en origin.modelflare.dev. Gemini CLI construye la misma ruta en /v1beta, que solo sirve modelflare.dev. |
| Vídeo | POST /v1/videos |
Seedance, Wan, Kling y otros modelos de vídeo asíncrono. Sondee GET /v1/videos/{task_id} y descargue GET /v1/videos/{task_id}/content. Envolvente exacta: modelos de vídeo. |
| Seedance activos | POST /volc/asset/* |
Crear, consultar, actualizar y eliminar grupos de activos y medios del lado del proveedor. Ver Gestión de activos de Seedance. |
| Modelos | GET /v1/models |
Lista de modelos a los que la clave actual puede llamar. |
Las solicitudes de imagen y vídeo de punto final incorrecto se rechazan con unsupported_endpoint. No envíe campos de imagen Gemini a /v1/images/* ni campos de imágenes GPT a generateContent. No mezcle campos Chat Completions en un cliente Responses o Anthropic.
La imagen y el video funcionan con una clave API inteligente o una clave API de grupo media. Las URL de resultados pueden caducar; transfiera el archivo después de que una tarea de video se realice correctamente.
Las llamadas de gestión de activos de Seedance aceptan las mismas claves: una clave API inteligente o una clave API de grupo media. La creación de activos es asincrónica; use GetAsset hasta Active, luego pase el asset://<ID> devuelto sin cambios en una solicitud Seedance compatible. La puerta de enlace mantiene la propiedad de los activos por usuario y no agrega un cargo por administración de recursos por separado.
Listar modelos para esta llave
Sección titulada «Listar modelos para esta llave»https://modelflare.dev/v1/modelscurl https://modelflare.dev/v1/models \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"La respuesta enumera los modelos que la clave actual puede llamar. No sustituye a Modelos y precios, que incluye precios, grupos y etiquetas de protocolo. Utilice exactamente id en el campo JSON model. Ver Modelos y grupos.