Справочник API

Аутентификация

Все запросы к API используют аутентификацию по bearer-токену. Создайте токен в личном кабинете и передавайте его в заголовке Authorization.

Authorization: Bearer $CHINAAPI_KEY
Content-Type: application/json

OpenAI-совместимый чат

Большинство клиентов OpenAI работают после смены baseURL. Используйте имя модели, опубликованное в вашем личном кабинете ChinaAPI.

Ключевые параметры: model и messages обязательны. Поведение генерации задают temperature, top_p, max_tokens и stream. reasoning_effort может принимать значения low, medium, high или значение, специфичное для модели, если выбранная модель рассуждений это поддерживает.

curl https://api.chinaapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CHINAAPI_KEY,
  baseURL: "https://api.chinaapi.ai/v1",
});

const result = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Hello" }],
});

Форматы запросов

Три формата запросов покрывают весь каталог. Один ключ ChinaAPI и один Base URL работают со всеми, поэтому отправляйте тот, на котором ваш клиент уже говорит.

Многошаговые диалоги Responses ссылаются на предыдущий ответ через previous_response_id. Если следующий запрос вернулся с previous_response_not_found, предыдущий ответ не потерян: подождите десять–двадцать секунд и отправьте тот же запрос снова, вместо того чтобы собирать диалог заново.

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

Модели видео отвечают задачами, а не одним ответом. POST /v1/videos возвращает идентификатор задачи со "status": "queued", а GET /v1/videos/{task_id} сообщает о ходе выполнения, пока задача не достигнет состояния completed или failed. По завершении готовый файл — это подписанный URL в metadata.url; он содержит параметр Expires, поэтому скачивайте файл, а не сохраняйте ссылку. Неудачная задача несёт код и текст вышестоящего сервиса в error.code и error.message, чего обычно достаточно, чтобы понять, какого поля не хватало в запросе. POST /v1/video/generations ведёт к тому же обработчику для клиентов, уже написанных под этот путь.

curl https://api.chinaapi.ai/v1/videos \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-i2v",
    "prompt": "the cat turns and walks toward the camera",
    "input_reference": "https://example.com/first-frame.jpg",
    "size": "1280*720",
    "duration": 5
  }'

# {"id":"task_9f2c...","task_id":"task_9f2c...","object":"video",
#  "model":"wan2.7-i2v","status":"queued","progress":0}

curl https://api.chinaapi.ai/v1/videos/task_9f2c... \
  -H "Authorization: Bearer $CHINAAPI_KEY"

# {"id":"task_9f2c...","object":"video","model":"wan2.7-i2v",
#  "status":"completed","progress":100,
#  "metadata":{"url":"https://.../output.mp4?Expires=..."}}

curl https://api.chinaapi.ai/v1/video/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "prompt": "the character from the references walks through a neon-lit street",
    "metadata": {
      "image_list": [
        {"image_url": "https://example.com/character.jpg"},
        {"image_url": "https://example.com/outfit.jpg"},
        {"image_url": "https://example.com/scene.jpg"}
      ],
      "mode": "std",
      "duration": "5",
      "aspect_ratio": "16:9",
      "sound": "off"
    }
  }'

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

# {"code":"success",
#  "data":{"task_id":"task_9f2c...","status":"SUCCESS",
#          "progress":"100%","fail_reason":"",
#          "result_url":"https://.../output.mp4"}}

curl https://api.chinaapi.ai/v1/videos \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "the subject slowly turns toward the camera",
    "images": ["https://example.com/first-frame.jpg"],
    "seconds": "5",
    "metadata": {"resolution": "480p"}
  }'

curl https://api.chinaapi.ai/v1/videos \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "keep the subject from the reference image",
    "seconds": "5",
    "metadata": {
      "resolution": "480p",
      "ratio": "16:9",
      "content": [
        {
          "type": "image_url",
          "image_url": {"url": "https://example.com/reference.jpg"},
          "role": "reference_image"
        }
      ]
    }
  }'

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

POST /v1/images/generations отвечает одним ответом, а не задачей. model и prompt обязательны; n, size и quality необязательны, и модели используют собственные значения по умолчанию. Ответ имеет вид {"created": …, "data": [ … ]}, где каждая запись содержит url, а b64_json присутствует, но пуст, пока вы не запросите его через "response_format": "b64_json". Редактирование существующего изображения выполняется через POST /v1/images/edits с исходником в image. Тарификация идёт за каждое созданное изображение, поэтому n умножает списание.

curl https://api.chinaapi.ai/v1/images/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "a red paper crane on a white desk, soft daylight",
    "n": 1
  }'

# {"created":1786620000,
#  "data":[{"url":"https://.../image_inference_output/....jpg","b64_json":""}],
#  "metadata":{"success_count":"1","failed_count":"0"}}

Текст в речь

POST /v1/audio/speech возвращает само аудио, а не JSON: телом ответа является закодированный файл, а Content-Type следует за response_format, поэтому mp3 возвращается как audio/mpeg. Значимые поля — model, input и voice; speed и instructions необязательны, а имена голосов каждая модель публикует свои. Записывайте ответ сразу в файл — попытка декодировать его как текст его испортит.

curl https://api.chinaapi.ai/v1/audio/speech \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "step-tts-2",
    "input": "ChinaAPI text to speech verification.",
    "voice": "cixingnansheng",
    "response_format": "mp3"
  }' \
  --output speech.mp3

# HTTP 200, Content-Type: audio/mpeg

Речь в текст

POST /v1/audio/transcriptions принимает multipart/form-data, а не JSON: передайте model как поле формы, а запись — как файловую часть с именем file. Ответ имеет вид {"text": "…"}. POST /v1/audio/translations устроен так же и возвращает английский текст. В отличие от эндпоинтов видео этот работает синхронно, поэтому длинная запись удерживает соединение открытым до завершения.

curl https://api.chinaapi.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -F model=stepaudio-2.5-asr \
  -F file=@speech.mp3

# {"text":" China api text to speech verification."}

Семейства моделей

Опубликуйте псевдонимы моделей, которыми должна пользоваться ваша команда, а затем сопоставьте их с вышестоящими каналами, резервными пулами, ценами и группами в личном кабинете.

Управление из личного кабинета

Ключи, пользователи, группы, состояние каналов, журналы, квоты и тарификация описаны в документации. Эта страница посвящена контракту протокола: эндпоинтам, параметрам, ответам и ошибкам.