Соберите свой первый запрос

Hermes Agent

Направьте блок model в ~/.hermes/config.yaml на шлюз или запустите hermes model и выберите Custom endpoint в интерактивном режиме. base_url содержит суффикс /v1; /chat/completions Hermes добавляет сам.

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

Claude Code

Экспортируйте три переменные окружения и запустите claude как обычно. Переменные ANTHROPIC_DEFAULT_*_MODEL сопоставляют внутренние уровни моделей Claude Code с моделями ChinaAPI — именно это позволяет запускать китайские модели внутри немодифицированного Claude Code.

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 говорит по протоколу Responses, поэтому wire_api должен быть responses; если оставить формат chat, вызовы инструментов сломаются. Поместите ключ в переменную окружения, названную в env_key. deepseek-v4-pro использует тот же формат, поэтому достаточно поменять имя модели, чтобы обменять стоимость на возможности.

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

Все три используют одну и ту же форму провайдера OpenAI Compatible, поле в поле. Вводите идентификатор модели ровно так, как он показан в разделе Консоль → Модели: для пользовательских провайдеров эти инструменты не запрашивают список моделей.

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

Cursor

Переопределите базовый URL в Settings → Models → OpenAI API Key. Сначала добавьте имя модели ChinaAPI через Add model, затем оставьте включёнными только модели ChinaAPI, иначе Cursor будет отправлять на ваш URL свои встроенные имена моделей.

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

OpenClaw

Объявите ChinaAPI как провайдера с "api": "anthropic-messages" и перечислите модели, которые должны быть доступны для выбора в сессии.

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

Aider

Aider выбирает маршрут по префиксу модели, поэтому сохраняйте префикс openai/ в имени модели, даже если сама модель китайская.

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

aider --model openai/deepseek-v4-pro

Генерация изображений

Отправьте промпт в JSON. Читайте созданный файл из data[0].url или из data[0].b64_json, если выбранная модель возвращает base64.

Ключевые параметры: prompt и model обязательны. size задаёт разрешение, n — количество изображений, response_format — url или b64_json. quality и style зависят от модели; распространённые значения — standard, hd или 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
  }'

Генерация изображений Gemini

Модели изображений Gemini используют форму запроса OpenAI Chat Completions. Читайте созданное изображение в формате Markdown из choices[0].message.content; полезная нагрузка изображения — это URL вида data:image/....

Ключевые параметры: передайте идентификатор модели из каталога в model, а промпт изображения — в messages. Не отправляйте эту модель на /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
  }'

Речь в текст

Загружайте аудио как multipart form data; не задавайте заголовок Content-Type вручную. Распознанный текст возвращается в поле text.

Ключевые параметры: передайте model и file как поля multipart. Используйте response_format со значением json, text или verbose_json, если выбранная модель это поддерживает.

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"

Текст в речь

Тело ответа — двоичное аудио, поэтому записывайте его в файл. alloy выбирает голос модели по умолчанию; модель может публиковать и собственные идентификаторы голосов.

Ключевые параметры: используйте input, model и voice. Формат вывода задаётся через response_format — например, mp3 или wav; speed и instructions доступны, если выбранная модель их поддерживает.

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

Генерация видео

Генерация видео асинхронная. Отправьте запрос один раз, сохраните возвращённый task_id, затем опрашивайте GET /v1/video/generations/{task_id}, пока задача не завершится успешно или с ошибкой. Создание задачи может списывать квоту.

Ключевые параметры: задачу запускают prompt и model. Там, где это поддерживается, используйте duration, width, height, fps и n. Разрешение — общий способ управления чёткостью. Параметры, специфичные для поставщика, такие как quality, quality_level, negative_prompt или настройки камеры, помещайте в metadata только тогда, когда они указаны для этой модели.

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"