Qual endpoint chamar

Modelflare usa uma chave de API em vários protocolos. O envelope JSON não é o mesmo para todos os modelos. Escolha primeiro a família e depois copie a solicitação do guia correspondente ou da página do modelo.

URL base

https://modelflare.dev/v1

O tráfego EdgeOne voltado para a China pode usar https://origin.modelflare.dev/v1 para a mesma aplicação. Escolha o host antes de enviar uma solicitação; não redirecione um POST em andamento entre hosts.

Anthropic são a exceção: ANTHROPIC_BASE_URL é https://modelflare.dev (a origem do site, não /v1). A CLI oficial Claude Code anexa o próprio caminho das mensagens. Consulte Claude Code.

Autenticação

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Envie este cabeçalho em todas as solicitações, incluindo pesquisas e downloads de vídeo. Crie a chave no console. Detalhes: Autenticação.

Famílias

Uma chave de API Modelflarehttps://modelflare.dev

Chat Completions

POST /v1/chat/completions

Bate-papo compatível com OpenAI.

Responses

POST /v1/responses

Codex e Grok Build.

Anthropic Messages

ANTHROPIC_BASE_URL=https://modelflare.dev

A CLI do Claude Code anexa o próprio caminho das Mensagens.

Imagens

POST /v1/images/generations

Imagens GPT, Imagem Wan e Seedream.

Gemini nativo

POST /v1/models/{model}:generateContent

Modelos de imagem Gemini. Gemini CLI usa a própria ortografia /v1beta.

Vídeo

POST /v1/videos

Cria uma tarefa: faça uma pesquisa e baixe o resultado.

Seedance ativos

POST /volc/asset/*

Gerencie grupos de ativos do Seedance e IDs de mídia do lado do provedor.

Modelos

GET /v1/models

O que a chave atual pode chamar.

Uma chave e um host, mas um contrato de solicitação diferente por família. A tabela abaixo está vinculada ao guia ou página do modelo de cada um.

Família	Entrada típica	Use-o para
Chat Completions	POST /v1/chat/completions	Bate-papo compatível com OpenAI. Primeira solicitação: Início rápido.
Responses	POST /v1/responses	Codex e Grok Build.
Anthropic Messages	Mensagens compatíveis com Anthropic	Claude Code.
Imagens	POST /v1/images/generations	Imagens GPT, Imagem Wan e Seedream. Campos exatos: modelos de imagem.
Gemini nativo	POST /v1/models/{model}:generateContent	Modelos de imagem Gemini; também serviu em origin.modelflare.dev. Gemini CLI constrói o mesmo caminho em /v1beta, que apenas modelflare.dev serve.
Vídeo	POST /v1/videos	Seedance, Wan, Kling e outros modelos de vídeo assíncronos. Enquete GET /v1/videos/{task_id} e download GET /v1/videos/{task_id}/content. Envelope exato: modelos de vídeo.
Seedance ativos	POST /volc/asset/*	Criar, consultar, atualizar e excluir grupos de ativos e mídia do lado do provedor. Consulte Seedance gerenciamento de ativos.
Modelos	GET /v1/models	Lista os modelos que a tecla atual pode chamar.

Solicitações de imagem e vídeo de endpoint errado são rejeitadas com unsupported_endpoint. Não envie campos de imagem Gemini para /v1/images/* ou campos de imagens GPT para generateContent. Não misture campos Chat Completions em um cliente Responses ou Anthropic.

Imagens e vídeos funcionam com uma chave de API inteligente ou uma chave de API de grupo media. Os URLs de resultados podem expirar; transferir o arquivo depois que uma tarefa de vídeo for bem-sucedida.

As chamadas de gerenciamento de ativos do Seedance aceitam as mesmas chaves: uma chave de API inteligente ou uma chave de API de grupo media. A criação de ativos é assíncrona; use GetAsset até Active e, em seguida, passe o asset://<ID> retornado inalterado em uma solicitação Seedance suportada. O gateway mantém a propriedade dos ativos por usuário e não adiciona uma cobrança separada de gerenciamento de recursos.

Listar modelos para esta chave

GEThttps://modelflare.dev/v1/models

bash

curl https://modelflare.dev/v1/models \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

A resposta lista os modelos que a chave atual pode chamar. Não substitui Modelos e preços, que inclui preços, grupos e rótulos de protocolo. Use o id exato no campo JSON model. Consulte Modelos e grupos.