API-ключ Zhen AI за пару минут
Один аккаунт, один ключ, все передовые модели. Самый короткий путь от регистрации до первого потокового токена.
4. Вызовите API
Направьте любой SDK, совместимый с OpenAI, Anthropic или Gemini, на точку доступа Zhen AI — без изменений в коде.
Совместимая аутентификация
Каждый ключ передаётся в стандартном заголовке Bearer. Один и тот же ключ работает с запросами в форматах OpenAI, Anthropic и Gemini — Zhen AI направит запрос к той модели, которую вы укажете.
Authorization: Bearer sk-...- Поддерживаются потоковые и обычные ответы
- Чтобы сменить поставщика, поменяйте поле
model— больше ничего в коде менять не нужно
curl https://api.zhenx.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.2",
"messages": [{"role":"user","content":"Hi"}],
"stream": true
}'Видео Seedance 2 и Wan 3.0 по вашему API-ключу
POST /v1/videos на www.zhenx.ai отправляет задачу Seedance 2.0 или Wan 3.0 Prime (model seedance-2.0 / wan3.0-prime). Оплата списывается с баланса Metered credit по тем же тарифам за секунду, что и в студии. Опрашивайте статус задачи и скачайте ролик в течение 7 дней — файл остаётся у вас, мы его нигде не публикуем.
- Отметьте seedance-2.0 и/или wan3.0-prime в списке разрешённых моделей ключа — ключ без явного разрешения генерировать видео не может.
- Для задач нужно не менее $2.00 на Metered credit; задача отклоняется (HTTP 402), если после её оплаты останется меньше $2.00. Пополнить от $5: Billing → Metered credit.
- Ролики доступны только вашему ключу и удаляются через 7 дней; GET …/content отдаёт их потоком (Range поддерживается), DELETE удаляет раньше.
Video API работает только на www.zhenx.ai. api.zhenx.ai — хост для чат-запросов, /v1/videos он не обслуживает.
# submit (202 → {"id": "gen_...", "status": "queued", ...})
curl https://www.zhenx.ai/v1/videos \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "a koi fish leaping out of an ink-wash river",
"resolution": "720p", "duration": 10, "ratio": "16:9"
}'
# poll until "status": "completed"
curl https://www.zhenx.ai/v1/videos/gen_... \
-H "Authorization: Bearer sk-..."
# download within 7 days
curl -L -o clip.mp4 https://www.zhenx.ai/v1/videos/gen_.../content \
-H "Authorization: Bearer sk-..."Пошагово
1. Пополните Metered credit
Войдите → Billing → Metered credit. Минимальное пополнение — $5 (¥40 через Alipay/WeChat Pay). Видео оплачивается по факту из этого кошелька; в тарифы оно не входит.
2. Создайте ключ с отметкой seedance-2.0
Keys → Create key. В разделе «Video models» отметьте seedance-2.0 и нажмите Create. Скопируйте ключ sk- — он показывается один раз. Ключ с пустым списком разрешённых моделей может вызывать все чат-модели, но НЕ видео: доступ к видео даёт только эта отметка. Существующие ключи редактировать нельзя — создайте новый.
3. Отправьте задачу
POST https://www.zhenx.ai/v1/videos с полями model, prompt, resolution, duration и ratio. seedance-2.0: 720p / 1080p / 4k, 5 / 10 / 12 / 15 с. wan3.0-prime: 480p / 720p / 1080p, 5–30 с, ratio может быть adaptive, плюс необязательные negative_prompt, prompt_extend и frame_mode "frames" (референсы становятся первым/последним кадром). В ответ придёт 202 с id, точной ценой и остатком баланса. Сумма резервируется в кошельке в этот момент.
4. Опрашивайте статус и скачайте за 7 дней
GET /v1/videos/{id}, пока status не станет completed, затем GET /v1/videos/{id}/content отдаст MP4 потоком (Range поддерживается). За неудачную задачу деньги возвращаются полностью. DELETE /v1/videos/{id} удаляет ролик досрочно.
Цена = тариф разрешения за секунду × длительность в секундах, с округлением до цента, и называется до любого списания — ответ 202 и карточка Billing → Metered credit в консоли показывают одни и те же цифры. Необязательно: generate_audio, seed и reference_images (URL из POST /v1/videos/uploads, multipart-поле `file`).
Возможные ответы
| 402 insufficient_metered_credit | Баланс меньше $2 или после этой задачи останется меньше $2. В теле ответа — balance_usd, estimated_cost_usd и required_usd (сумма пополнения, при которой задача пройдёт), а также topup_url. |
| 403 model_not_allowed | У этого ключа не отмечена модель seedance-2.0. Создайте ключ с этой отметкой. |
| 429 rate_limited | У ключа больше 3 задач в работе или больше 10 отправок за минуту. |
| 422 content_rejected | Фильтр контента поставщика отклонил запрос или референс. Ничего не списано. |
| 410 content_expired | Ролик удалён из хранилища — прошло 7 дней или вы удалили его сами. Сохраняйте свою копию. |
Вы решаете, насколько глубоко думает модель
Рассуждающие модели принимают необязательное поле reasoning_effort. Zhen AI передаёт его модели как есть — мы не подставляем значение по умолчанию, не ограничиваем и не переписываем то, что вы отправили, так что баланс между качеством ответа, задержкой и расходами остаётся за вами.
Допустимые значения
none- Без рассуждений — быстрее и дешевле всего. Лучше всего для коротких фактических ответов, извлечения и форматирования.
low- Короткое обдумывание. Разумный выбор на каждый день для чата и простых вызовов инструментов.
medium- Сбалансированная глубина для многошаговых вопросов.
high- Развёрнутые рассуждения для сложного анализа, планирования и длинных агентных циклов.
max- Максимальная глубина, доступная модели. Медленнее всего и тратит больше всего выходных токенов.
curl https://api.zhenx.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.2",
"messages": [{"role":"user","content":"Plan this migration"}],
"reasoning_effort": "high",
"stream": true
}'- Если не указывать поле, модель использует собственное значение по умолчанию.
- Токены рассуждений оплачиваются как выходные, поэтому более высокий уровень стоит дороже — повышайте его осознанно, а не по умолчанию.
- Модели без рассуждений игнорируют это поле. Любое значение не из списка выше поставщик отклонит с ошибкой 400.