Use una única Base URL para acceder a modelos de IA chinos.

Hermes Agent

Apunte el bloque model de ~/.hermes/config.yaml al gateway, o ejecute hermes model y elija Custom endpoint de forma interactiva. base_url incluye el sufijo /v1; Hermes añade /chat/completions por su cuenta.

model:
  default: kimi-k2.7-code
  provider: custom
  base_url: https://api.chinaapi.ai/v1
  api_key: <your ChinaAPI key>

Claude Code

Exporte las tres variables de entorno e inicie claude como de costumbre. Las variables ANTHROPIC_DEFAULT_*_MODEL asignan los niveles internos de modelo de Claude Code a modelos de ChinaAPI, lo que permite ejecutar modelos chinos dentro de un Claude Code sin modificar.

export ANTHROPIC_BASE_URL=https://api.chinaapi.ai
export ANTHROPIC_AUTH_TOKEN=$CHINAAPI_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k3
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.7-code
export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5-turbo

claude

Codex

Codex habla el protocolo Responses, por lo que wire_api debe ser responses; dejarlo en el formato chat rompe las llamadas a herramientas. Coloque su clave en la variable de entorno indicada por env_key.

model = "deepseek-v4-flash"
model_provider = "chinaapi"

[model_providers.chinaapi]
name = "ChinaAPI"
base_url = "https://api.chinaapi.ai/v1"
wire_api = "responses"
env_key = "CHINAAPI_KEY"

Cline, Roo Code, Kilo Code

Los tres usan el mismo formulario de proveedor OpenAI Compatible, campo por campo. Introduzca el ID de modelo exactamente como aparece en Consola → Modelos; estas herramientas no obtienen automáticamente la lista de modelos para proveedores personalizados.

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model ID   glm-5.2

Cursor

Sustituya el base URL en Settings → Models → OpenAI API Key. Primero añada el nombre del modelo de ChinaAPI con Add model, y deje activados solo los modelos de ChinaAPI, porque de lo contrario Cursor enviará sus nombres de modelo integrados a la URL sustituida.

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model      deepseek-v4-pro

OpenClaw

Declare ChinaAPI como proveedor con "api": "anthropic-messages" y enumere los modelos que desee que aparezcan en el selector de sesión.

{
  "models": {
    "providers": {
      "chinaapi": {
        "baseUrl": "https://api.chinaapi.ai",
        "apiKey": "<your ChinaAPI key>",
        "api": "anthropic-messages",
        "models": ["kimi-k3", "glm-5.2"]
      }
    }
  }
}

Aider

Aider enruta según el prefijo del nombre del modelo, así que conserve el prefijo openai/ en el nombre del modelo aunque el modelo en sí sea chino.

export OPENAI_API_BASE=https://api.chinaapi.ai/v1
export OPENAI_API_KEY=$CHINAAPI_KEY

aider --model openai/deepseek-v4-pro

Generación de imágenes

Envíe un prompt en JSON. Lea el recurso generado desde data[0].url, o desde data[0].b64_json cuando el modelo seleccionado devuelva base64.

Parámetros clave: prompt y model son obligatorios. Use size para la resolución, n para el número de imágenes y response_format para url o b64_json. quality y style son específicos de cada modelo; los valores habituales incluyen standard, hd o auto.

curl https://api.chinaapi.ai/v1/images/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic skyline at blue hour",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1
  }'

Generación de imágenes de Gemini

Los modelos de imagen de Gemini usan el formato de solicitud de OpenAI Chat Completions. Lea la imagen en Markdown generada desde choices[0].message.content; el payload de la imagen es una URL data:image/....

Parámetros clave: envíe el ID de modelo del catálogo, visible tras iniciar sesión, en model y el prompt de imagen en messages. No envíe este modelo a /v1/images/generations.

curl https://api.chinaapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<GEMINI_IMAGE_MODEL>",
    "messages": [
      {
        "role": "user",
        "content": "Generate a cinematic skyline at blue hour"
      }
    ],
    "stream": false
  }'

Voz a texto

Suba el audio como multipart form data; no configure manualmente el encabezado Content-Type. El texto reconocido se devuelve en el campo text.

Parámetros clave: envíe model y file como campos multipart. Use response_format con json, text o verbose_json cuando el modelo seleccionado lo admita.

curl https://api.chinaapi.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -F "model=qwen3-asr-flash" \
  -F "file=@speech.wav" \
  -F "response_format=json"

Texto a voz

El cuerpo de la respuesta es audio binario, así que guárdelo en un archivo. alloy selecciona la voz predeterminada del modelo; un modelo también puede publicar ID de voz propios del proveedor.

Parámetros clave: use input, model y voice. Elija una salida con response_format, como mp3 o wav; speed e instructions están disponibles cuando el modelo seleccionado lo admita.

curl https://api.chinaapi.ai/v1/audio/speech \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-v2.5-tts",
    "input": "Hello from ChinaAPI.",
    "voice": "alloy",
    "response_format": "mp3"
  }' \
  --output speech.mp3

Generación de vídeo

La generación de vídeo es asíncrona. Envíe la solicitud una sola vez, guarde el task_id devuelto y luego consulte GET /v1/video/generations/{task_id} hasta que la tarea tenga éxito o falle. Crear una tarea puede consumir cuota.

Parámetros clave: prompt y model inician la tarea. Use duration, width, height, fps y n cuando estén disponibles. La resolución es el control de nitidez habitual. Coloque controles específicos del proveedor, como quality, quality_level, negative_prompt o ajustes de cámara, en metadata solo cuando estén indicados para ese modelo.

curl https://api.chinaapi.ai/v1/video/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "A paper boat crossing a moonlit lake",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

curl https://api.chinaapi.ai/v1/video/generations/$TASK_ID \
  -H "Authorization: Bearer $CHINAAPI_KEY"

Embeddings

Envíe una cadena o un array de cadenas. Los vectores se devuelven en data[].embedding en el mismo orden que las entradas.

Parámetros clave: input acepta una única cadena o un lote. Use dimensions y encoding_format solo cuando el modelo de embedding seleccionado lo admita.

curl https://api.chinaapi.ai/v1/embeddings \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-v4",
    "input": ["ChinaAPI connects Chinese AI models."]
  }'

Rerank

Clasifique documentos candidatos frente a una consulta. Lea los resultados ordenados y las puntuaciones de relevancia en results.

Parámetros clave: envíe query y documents; use top_n para limitar el número de candidatos clasificados devueltos.

curl https://api.chinaapi.ai/v1/rerank \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gte-rerank-v2",
    "query": "How do I call Chinese AI models?",
    "documents": [
      "Use one ChinaAPI Base URL and API key.",
      "Install a local database."
    ],
    "top_n": 2
  }'