Tenha sua chave de API da Zhen AI em minutos
Uma conta, uma chave, todos os modelos de ponta. Este é o caminho mais rápido do cadastro ao seu primeiro token em streaming.
4. Chame a API
Aponte qualquer SDK compatível com OpenAI, Anthropic ou Gemini para o endpoint da Zhen AI — sem mudar o código.
Autenticação compatível, sem adaptação
Toda chave se autentica com um header bearer padrão. Use a mesma chave em requisições no formato OpenAI, Anthropic ou Gemini — a Zhen AI roteia para o modelo upstream que você indicar.
Authorization: Bearer sk-...- Respostas com e sem streaming suportadas
- Troque o campo
modelpara mudar de provedor — nenhuma outra alteração no código
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
}'Gere vídeo com Seedance 2 ou Wan 3.0 usando sua chave de API
POST /v1/videos em www.zhenx.ai envia um job do Seedance 2.0 ou do Wan 3.0 Prime (model seedance-2.0 / wan3.0-prime), cobrado do seu Metered credit pelas mesmas tarifas por segundo do studio. Consulte o status do job e baixe o clipe em até 7 dias — o arquivo é seu, não o exibimos em lugar nenhum.
- Marque seedance-2.0 e/ou wan3.0-prime na lista de modelos permitidos da chave — uma chave sem essa marcação não gera vídeo.
- Os jobs exigem pelo menos $2.00 de Metered credit e são recusados (HTTP 402) se o preço do job deixar menos de $2.00. Adicione $5 ou mais em Billing → Metered credit.
- Os clipes são privados da sua chave e apagados após 7 dias; GET …/content faz o streaming (com suporte a Range) e DELETE os remove antes.
A API de vídeo fica apenas em www.zhenx.ai. api.zhenx.ai é o host do relay de chat e não atende /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-..."Passo a passo
1. Adicione Metered credit
Entre → Billing → Metered credit. A recarga mínima é $5 (¥40 via Alipay/WeChat Pay). O vídeo é pago por uso a partir dessa carteira; os planos não o incluem.
2. Crie uma chave com seedance-2.0 marcado
Keys → Create key. Em "Video models", marque seedance-2.0 e clique em Create. Copie a chave sk- — ela aparece uma única vez. Uma chave com a lista de permitidos vazia chama todos os modelos de chat, mas NÃO vídeo; o vídeo só é liberado por essa marcação. Chaves existentes não podem ser editadas: crie uma nova.
3. Envie um job
POST https://www.zhenx.ai/v1/videos com model, prompt, resolution, duration e ratio. seedance-2.0: 720p / 1080p / 4k, 5 / 10 / 12 / 15 s. wan3.0-prime: 480p / 720p / 1080p, 5–30 s, ratio pode ser adaptive, além de negative_prompt, prompt_extend e frame_mode "frames" opcionais (as imagens de referência viram o primeiro/último frame). Você recebe 202 com um id, o preço exato e o saldo restante. O preço é reservado na carteira nesse momento.
4. Consulte o status e baixe em até 7 dias
GET /v1/videos/{id} até o status ser completed; depois, GET /v1/videos/{id}/content faz o streaming do MP4 (com suporte a Range). Um job que falha é reembolsado integralmente. DELETE /v1/videos/{id} remove o clipe antes do prazo.
Preço = tarifa por segundo da resolução × duração em segundos, arredondado ao centavo e cotado antes de qualquer gasto — a resposta 202 e o card Billing → Metered credit do console mostram os mesmos números. Opcionais: generate_audio, seed e reference_images (URLs de POST /v1/videos/uploads, campo multipart `file`).
Respostas que você pode receber
| 402 insufficient_metered_credit | O saldo está abaixo de $2, ou este job deixaria menos de $2. O corpo informa balance_usd, estimated_cost_usd e required_usd (a recarga que permite rodar o job), além de topup_url. |
| 403 model_not_allowed | seedance-2.0 não está marcado nesta chave. Crie uma chave com ele marcado. |
| 429 rate_limited | Mais de 3 jobs em andamento nesta chave, ou mais de 10 envios em um minuto. |
| 422 content_rejected | O filtro de conteúdo do upstream recusou o prompt ou uma imagem de referência. Nada é cobrado. |
| 410 content_expired | O clipe saiu do armazenamento — passaram 7 dias ou você o apagou. Guarde sua própria cópia. |
Você decide o quanto o modelo pensa
Modelos de raciocínio aceitam o campo opcional reasoning_effort. A Zhen AI repassa o valor direto para o modelo upstream — nunca injetamos um padrão, limitamos ou reescrevemos o que você envia, então o equilíbrio entre qualidade da resposta, latência e custo continua nas suas mãos.
Valores aceitos
none- Nenhum raciocínio — o mais rápido e barato. Ideal para respostas factuais curtas, extração e formatação.
low- Uma reflexão breve. Um bom padrão do dia a dia para chat e chamadas de ferramentas simples.
medium- Profundidade equilibrada para perguntas com várias etapas.
high- Raciocínio estendido para análises difíceis, planejamento e loops longos de agentes.
max- O nível mais profundo que o modelo oferece. O mais lento, e o que mais gera tokens de saída cobrados.
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
}'- Omita o campo e o modelo usa o próprio padrão.
- Tokens de raciocínio são cobrados como tokens de saída, então um nível mais alto custa mais — aumente de propósito, não por padrão.
- Modelos sem raciocínio ignoram o campo. Qualquer valor fora da lista acima é rejeitado pelo upstream com um 400.