Obtén tu API key de Zhen AI en minutos
Una cuenta, una key, todos los modelos de frontera. Este es el camino más corto del registro a tu primer token en streaming.
4. Llama a la API
Apunta cualquier SDK compatible con OpenAI, Anthropic o Gemini al endpoint de Zhen AI — sin cambiar código.
Autenticación compatible de inmediato
Cada key se autentica con un header bearer estándar. Usa la misma key en solicitudes con formato de OpenAI, Anthropic o Gemini — Zhen AI enruta al modelo upstream que indiques.
Authorization: Bearer sk-...- Respuestas con y sin streaming
- Cambia el campo
modelpara cambiar de proveedor — sin tocar nada más del 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
}'Genera video con Seedance 2 o Wan 3.0 usando tu API key
POST /v1/videos en www.zhenx.ai envía un trabajo de Seedance 2.0 o Wan 3.0 Prime (model seedance-2.0 / wan3.0-prime) que se cobra de tu crédito Metered a las mismas tarifas por segundo que en el studio. Consulta el estado del trabajo y descarga el clip dentro de 7 días — el archivo es tuyo, no lo publicamos en ninguna parte.
- Marca seedance-2.0 y/o wan3.0-prime en la lista de modelos permitidos de la key — una key sin restricciones no puede generar video.
- Los trabajos requieren al menos $2.00 de crédito Metered, y se rechazan (HTTP 402) si su precio dejaría menos de $2.00. Agrega $5 o más en Billing → Metered credit.
- Los clips son privados para tu key y se eliminan a los 7 días; GET …/content los transmite (admite Range) y DELETE los borra antes.
La API de video solo está en www.zhenx.ai. api.zhenx.ai es el host del relay de chat y no sirve /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-..."Paso a paso
1. Agrega crédito Metered
Inicia sesión → Billing → Metered credit. La recarga mínima es de $5 (¥40 con Alipay/WeChat Pay). El video se paga por uso desde este monedero; los planes no lo incluyen.
2. Crea una key con seedance-2.0 marcado
Keys → Create key. En "Video models" marca seedance-2.0 y luego Create. Copia la key sk- — se muestra una sola vez. Una key con la lista de permitidos vacía puede llamar a todos los modelos de chat pero NO a video; el video solo se habilita con esa casilla. Las keys existentes no se pueden editar: crea una nueva.
3. Envía un trabajo
POST https://www.zhenx.ai/v1/videos con model, prompt, resolution, duration y ratio. seedance-2.0: 720p / 1080p / 4k, 5 / 10 / 12 / 15 s. wan3.0-prime: 480p / 720p / 1080p, 5–30 s, ratio puede ser adaptive, más negative_prompt, prompt_extend y frame_mode "frames" opcionales (las imágenes de referencia pasan a ser el primer/último fotograma). Recibes un 202 con un id, el precio exacto y tu saldo restante. En ese momento el precio se reserva del monedero.
4. Consulta el estado y descarga en 7 días
GET /v1/videos/{id} hasta que status sea completed; luego GET /v1/videos/{id}/content transmite el MP4 (admite Range). Un trabajo fallido se reembolsa por completo. DELETE /v1/videos/{id} borra el clip antes de tiempo.
Precio = tarifa por segundo de la resolución × duración en segundos, redondeado al centavo y cotizado antes de cualquier cargo — la respuesta 202 y la tarjeta Billing → Metered credit de la consola muestran las mismas cifras. Opcionales: generate_audio, seed y reference_images (URLs de POST /v1/videos/uploads, campo multipart `file`).
Respuestas que puedes ver
| 402 insufficient_metered_credit | El saldo es menor a $2, o este trabajo dejaría menos de $2. El cuerpo indica balance_usd, estimated_cost_usd y required_usd (la recarga que permite ejecutar el trabajo), además de topup_url. |
| 403 model_not_allowed | seedance-2.0 no está marcado en esta key. Crea una key con esa casilla marcada. |
| 429 rate_limited | Más de 3 trabajos en curso en esta key, o más de 10 envíos en un minuto. |
| 422 content_rejected | El filtro de contenido upstream rechazó el prompt o una imagen de referencia. No se cobra nada. |
| 410 content_expired | El clip ya no está en almacenamiento — pasaron 7 días o lo borraste. Guarda tu propia copia. |
Tú decides cuánto piensa el modelo
Los modelos de razonamiento aceptan un campo opcional reasoning_effort. Zhen AI lo pasa tal cual al modelo upstream — nunca inyectamos un valor por defecto, ni lo limitamos, ni reescribimos lo que envías, así que el equilibrio entre calidad de respuesta, latencia y gasto sigue siendo tuyo.
Valores aceptados
none- Sin razonamiento — lo más rápido y barato. Ideal para respuestas factuales cortas, extracción y formato.
low- Una reflexión breve. Un ajuste sensato para el día a día en chat y llamadas simples a herramientas.
medium- Profundidad equilibrada para preguntas de varios pasos.
high- Razonamiento extendido para análisis difíciles, planificación y loops largos de agentes.
max- El nivel más profundo que ofrece un modelo. El más lento, y el que más tokens de salida factura.
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
}'- Si omites el campo por completo, el modelo usa su propio valor por defecto.
- Los tokens de razonamiento se facturan como tokens de salida, así que un nivel más alto cuesta más — súbelo a propósito, no por defecto.
- Los modelos sin razonamiento ignoran el campo. Cualquier valor fuera de la lista anterior se rechaza upstream con un 400.