# 1折AI · Documentación completa
# Documentación de 1ZheAI
Source: https://1zheai.com/es/docs/
Markdown: https://1zheai.com/es/docs/index.md
---
title: "Documentación de 1ZheAI"
description: "Punto de entrada para el uso de la API de modelos, cuentas listas para usar y recarga de suscripciones, avisos de compra, pedidos y reglas de servicio postventa."
headingIds: {"Integración de la API de modelos":"section-1","¿Qué quieres hacer?":"section-2","Consulta y soporte":"section-3","Preguntas más frecuentes antes de usar":"section-4","Referencia rápida para desarrolladores":"section-5"}
---
Empieza por lo que necesitas: conectar una API de modelos, comprar una cuenta de IA o activar una suscripción en una cuenta existente.
Confirma la plataforma, el nivel de suscripción, el contenido entregado y las precauciones del primer inicio de sesión.Verifica las condiciones de la cuenta, los datos requeridos y el proceso de activación.Confirma la región, la vigencia, el método de canje y la cuenta aplicable.Conoce las reglas de cancelación, anomalías en la entrega, bloqueo de cuenta y reembolsos.
## Integración de la API de modelos
1折AI ofrece las API de Claude y OpenAI / GPT, compatibles con Anthropic Messages, OpenAI Responses y Chat Completions. Las interfaces más utilizadas incluyen: la nativa de Anthropic `/v1/messages`, y la compatible con OpenAI `/v1/chat/completions`. En el código y las herramientas que ya tienes, normalmente solo hay que cambiar dos cosas: la URL base y la clave de API (API key).
```text
Anthropic Base URL https://1zheai.com
OpenAI Base URL https://1zheai.com/v1
API Key sk-...（在控制台创建）
```
La entrada y salida de Claude se facturan con el descuento de cada modelo; la lectura y escritura de caché se facturan al precio oficial sin descuento. Los precios y las unidades de facturación de GPT, MiMo y los modelos de generación de imágenes se encuentran en [Modelos y precios](https://1zheai.com/en/pricing/).
Claude, GPT, MiMo y los modelos de generación de imágenes ya están disponibles; la lista completa se encuentra en [Modelos compatibles](/es/docs/models/).
## ¿Qué quieres hacer?
Claude Code, Codex CLI, Cursor, Cline, Cherry Studio y CC Switch. Primero revisa el alcance de compatibilidad y luego configura siguiendo los pasos.Comienza con el SDK de Anthropic, el SDK de OpenAI o curl, y sigue conociendo la salida en streaming.Documentación legible por máquina, manifiesto de páginas e instrucciones de integración de IA copiables.Regístrate, crea una clave de API y completa tu primera solicitud.
## Consulta y soporte
Busca endpoints, protocolos, ejemplos y alcance de compatibilidad.Consulta costos, registros de llamadas y vías de resolución de problemas.
## Preguntas más frecuentes antes de usar
Revisa los campos devueltos y el uso; estas comprobaciones no pueden demostrar por sí solas el origen del modelo.
Cómo activar la caché, cómo ver los aciertos y cuánto ahorra tras un acierto.
Qué significa cada caso de 401, 404, 429 y 5xx.
Métodos de pago, reembolso en 7 días, reglas de facturación.
## Referencia rápida para desarrolladores
| Tu tarea | Consulta directa |
| --- | --- |
| Escribir código por primera vez | [Ejemplo completo y ejecutable](/es/docs/code-examples/) |
| Migrar desde otra plataforma | [Guía de migración](/es/docs/migration/) |
| Consultar modelos y protocolos | [Consulta de modelos](/es/docs/api-models/) · [Referencia de interfaces](/es/docs/api-reference/) |
| Manejar tiempos de espera y límite de tasa | [Tiempos de espera y reintentos](/es/docs/retries/) |
| Buscar dudas frecuentes | [FAQ de integración](/es/docs/faq/) |
---
# Inicio rápido
Source: https://1zheai.com/es/docs/quickstart/
Markdown: https://1zheai.com/es/docs/quickstart.md
---
title: "Inicio rápido"
description: "Crea una clave API de 1zheAI, llama a Claude / GPT con curl o SDK e intégralo en tus clientes habituales."
headingIds: {"También puedes empezar con GPT":"section-1","Siguiente paso":"section-2"}
---
Objetivo: obtener una clave API (API key) en 5 minutos y completar tu primera solicitud a Claude o GPT.
Abre [1zheai.com/register](https://1zheai.com/register?lng=es) para registrarte. Las llamadas consumen saldo según el uso, así que primero debes recargar. El saldo se mide en USD y admite WeChat, Alipay, Stripe (tarjeta bancaria) y USDT; los métodos concretos y los límites de importe se indican en la página de pedido de la billetera. Dentro de los 7 días posteriores a la recarga puedes solicitar el reembolso del principal no consumido por el mismo canal de pago; la parte ya consumida y las tarifas de procesamiento de pago no se reembolsan. Las reglas están en[Recargas, reembolsos e facturas](/es/docs/billing/).
Entra en[Consola](https://1zheai.com/console?lng=es), en el menú lateral pulsa «Clave API» y luego «Crear clave API» en la esquina superior derecha; ponle un nombre y guarda. La clave API empieza por `sk-`; en la lista, pulsa el icono de copiar para guardarla. Los detalles están en[Obtener y gestionar claves API](/es/docs/api-keys/).
Coloca la clave API en una variable de entorno y llama una vez a la interfaz nativa de Anthropic con curl:
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "用一句话解释什么是 HTTP"}]
}'
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$body = @{
model = "claude-sonnet-5-5"
max_tokens = 128
messages = @(@{ role = "user"; content = "用一句话解释什么是 HTTP" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post `
-Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
```
`ONEZHE_API_KEY` es solo un nombre de variable de ejemplo; puedes usar el que quieras.
En caso de éxito devuelve HTTP 200, con una estructura idéntica a la oficial. Fíjate en dos puntos: que `model` sea el modelo que solicitaste y el número de tokens en `usage`. A continuación, la respuesta medida en vivo el 2026-10-15:
```json
{
"model": "claude-sonnet-5-5",
"id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
}
],
"container": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"stop_details": null,
"usage": {
"input_tokens": 530,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 69,
"output_tokens_details": {"thinking_tokens": 0},
"service_tier": "standard",
"inference_geo": "global"
},
"input_transformations": [],
"diagnostics": null,
"context_management": {"applied_edits": []}
}
```
`input_tokens` supera en cientos a la propia pregunta; es el aviso de sistema que estos clientes (curl, SDK, herramientas de terceros) adjuntan en cada solicitud, se factura como entrada, y Claude Code no lo adjunta; ver[Facturación del aviso de sistema](/es/docs/pricing-explained/#section-3).
Después, en «Registro de llamadas» del menú lateral de la consola verás esta llamada: hora, clave API usada (columna «Token»), modelo, tokens de entrada / salida, lectura y escritura de caché y coste.
## También puedes empezar con GPT
Si usas el SDK de OpenAI o vas a integrar Codex, puedes elegir directamente el protocolo GPT. Primero define en el mismo terminal el `ONEZHE_API_KEY` de arriba y luego ejecuta:
```bash
curl --fail-with-body https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'
```
Este es un ejemplo de shell en macOS / Linux; en Windows puedes ejecutar directamente los[ejemplos multiplataforma en Python / Node.js](/es/docs/code-examples/). El texto está en `choices[0].message.content`; si el modelo no está en tu lista, consulta antes[los modelos disponibles](/es/docs/api-models/). Codex necesita Responses; intégralo según el[tutorial de configuración de Codex](/es/docs/quickstart-codex/).
## Siguiente paso
Conéctalo a tus herramientas habituales:
Dos variables de entorno bastan.
Úsalo si no quieres editar a mano los archivos de configuración.
Forma de escribir y restricciones de la Base URL personalizada.
Si ya tienes código de OpenAI, solo cambia base_url.
Si la solicitud falla, consulta primero[los códigos de error y la resolución de problemas](/es/docs/troubleshooting/). Para verificar los campos devueltos y el uso, consulta[verificar modelo y uso](/es/docs/verify-model/).
---
# Obtener y gestionar claves API
Source: https://1zheai.com/es/docs/api-keys/
Markdown: https://1zheai.com/es/docs/api-keys.md
---
title: "Obtener y gestionar claves API"
description: "Cómo crear claves API que empiezan con sk- en la consola de 1zheai, y cómo almacenarlas, rotarlas y mitigar daños en caso de filtración."
headingIds: {"Crear una clave API":"section-1","Una clave API por herramienta":"section-2","Dónde guardarla":"section-3","Qué hacer si se filtra":"section-4","Preguntas frecuentes":"section-5"}
---
Una clave API (API key) corresponde a un permiso de llamada, y se descuenta del saldo de tu cuenta. Esta página explica cómo crearla, dónde guardarla y qué hacer si hay un incidente.
## Crear una clave API
Abre [1zheai.com/console](https://1zheai.com/console?lng=es).
En el menú lateral, haz clic en «Claves API» y luego en «Crear clave API» en la esquina superior derecha. Escribe un nombre que indique su propósito, por ejemplo `claude-code-macbook`, `ci-staging`; el resto de los campos puede quedarse sin cambios y funcionará igual. Haz clic en «Guardar cambios».
Campos configurables del formulario:
| Campo del formulario | Valor predeterminado | Descripción |
|---|---|---|
| Nombre | Vacío | Distingue las claves API en el registro de llamadas por este nombre |
| Fecha de caducidad | Nunca caduca | Opcional: 1 hora, 1 día, 1 mes, o especificar una fecha y hora concretas |
| Cantidad | 1 | Crea varias a la vez; al nombre se le añade automáticamente un sufijo aleatorio |
| Interruptor «Cuota ilimitada» | Activado | Al desactivarlo aparece «Límite (USD)»; esta clave API no podrá gastar más de esa cantidad en dólares |
| Restricción de modelos (en «Configuración avanzada») | Vacío, lo que significa que todos los modelos están disponibles | Si se eligen modelos, esta clave API solo podrá invocar esos modelos |
| Lista blanca de IP (en «Configuración avanzada») | Vacío, lo que significa sin restricción | Solo permite las llamadas desde las IP o rangos CIDR listados |
Las claves API empiezan por `sk-`. Después de copiarla, guárdala en un gestor de contraseñas o en una variable de entorno; no la pegues en chats, capturas de pantalla ni repositorios de código.
## Una clave API por herramienta
Se recomienda crear una clave API distinta para cada herramienta y cada máquina. Hay tres ventajas:
- El registro de llamadas se distingue por clave API, de modo que se ve de un vistazo cuánto gastó cada herramienta.
- Si se filtra una clave API, solo hay que eliminar esa; el resto de herramientas no se ven afectadas.
- Cada persona del equipo es responsable de su propia clave API; al irse o cambiar de máquina, se elimina la clave API correspondiente.
## Dónde guardarla
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
El `.claude/settings.json` a nivel de proyecto de Claude Code suele subirse al repositorio, y la documentación oficial de Claude Code recomienda explícitamente no escribir credenciales ahí. Coloca la clave API en el `~/.claude/settings.json` a nivel de usuario, o en un `.claude/settings.local.json` del proyecto que no se suba al repositorio.
## Qué hacer si se filtra
1. Encuéntrala en la lista de «Claves API», haz clic en el icono «Deshabilitar» de la columna «Acciones», o elige «Eliminar» en el menú «⋯». Al deshabilitarla deja de funcionar de inmediato; cualquier llamada posterior con ella devuelve 401 `Invalid token`.
2. Crea una clave API nueva y reemplázala donde se esté usando.
3. Abre el registro de llamadas (menú de la consola «Registro de llamadas»), haz clic en «Expandir», filtra escribiendo el nombre de esta clave API en «Nombre del token» y comprueba si entre las llamadas recientes hay alguna que no hayas iniciado tú.
## Preguntas frecuentes
Sí, una clave API no está vinculada a una herramienta. Solo que, si se mezclan, en el registro no se distingue quién gastó, por lo que se recomienda crearlas por separado.
En la mayoría de los casos, sí. Causas habituales: al copiarla se incluyeron espacios o saltos de línea, la clave API ya fue eliminada, o se introdujo en un campo incorrecto de la herramienta. Para revisarlo paso a paso, consulta[ códigos de error y solución de problemas](/es/docs/troubleshooting/).
Por defecto, nunca caduca. Al crearla o editarla puedes fijar una fecha en «Fecha de caducidad»; una vez caducada, cualquier llamada devuelve 401 `Invalid token`, igual que la respuesta cuando la clave API está mal escrita. La columna «Caducidad» de la lista muestra la fecha de caducidad de cada clave API.
---
# Modelos compatibles
Source: https://1zheai.com/es/docs/models/
Markdown: https://1zheai.com/es/docs/models.md
---
title: "Modelos compatibles"
description: "Consulta el alcance de disponibilidad, los IDs de modelo, las interfaces y los precios de Claude, GPT, MiMo y los modelos de generación de imágenes."
headingIds: {"Lista de modelos":"section-1","Ambas interfaces se pueden usar":"section-2","Modelos OpenAI / GPT":"section-3","Modelos MiMo":"section-4","Consultar la lista más reciente con la interfaz":"section-5","Cómo elegir":"section-6","Preguntas frecuentes":"section-7","Modelos de imágenes y consulta de interfaces":"section-8"}
---
Los modelos de Claude, GPT, MiMo y de generación de imágenes ya están disponibles. A continuación se enumeran los IDs de modelo de Claude y GPT; el alcance completo de disponibilidad se rige por el catálogo de modelos y la respuesta de la interfaz.
Consulta [modelos y precios públicos](https://1zheai.com/en/pricing/) para ver las tarifas; los usuarios con sesión iniciada pueden ir a [Consola · Modelos](https://1zheai.com/model-catalog?lng=es) para consultar los modelos y ver cómo integrarlos.
## Lista de modelos
El `model` de la solicitud debe coincidir exactamente con los IDs de la tabla siguiente, incluido el sufijo de fecha.
| ID de modelo | Serie | Descripción |
|---|---|---|
| `claude-fable-5-1` | Fable 5.1 | |
| `claude-fable-5` | Fable 5 | |
| `claude-opus-5-5` | Opus 5.5 | |
| `claude-opus-5` | Opus 5 | |
| `claude-opus-4-8` | Opus 4.8 | |
| `claude-opus-4-7` | Opus 4.7 | |
| `claude-opus-4-6` | Opus 4.6 | |
| `claude-opus-4-5-20251101` | Opus 4.5 | ID de versión fija con fecha |
| `claude-sonnet-5-5` | Sonnet 5.5 | |
| `claude-sonnet-5` | Sonnet 5 | |
| `claude-sonnet-4-6` | Sonnet 4.6 | |
| `claude-sonnet-4-5-20250929` | Sonnet 4.5 | ID de versión fija con fecha |
| `claude-haiku-5-5` | Haiku 5.5 | |
| `claude-haiku-4-5-20251001` | Haiku 4.5 | ID de versión fija con fecha |
El precio unitario de cada modelo (entrada, salida, lectura de caché, escritura de caché) se encuentra en la [página de precios](https://1zheai.com/en/pricing/). Las capacidades, la longitud del contexto y las notas de lanzamiento de cada modelo se rigen por la [documentación oficial de modelos de Anthropic](https://platform.claude.com/docs/en/about-claude/models/overview).
## Ambas interfaces se pueden usar
Los modelos de la tabla anterior se pueden invocar tanto a través de la interfaz nativa de Anthropic `/v1/messages` como de la interfaz compatible con OpenAI `/v1/chat/completions`, con la misma sintaxis de ID de modelo. Cuando necesites parámetros exclusivos de Claude como caché, thinking o llamadas a herramientas, usa la interfaz nativa; consulta [URL base y autenticación](/es/docs/base-url/).
## Modelos OpenAI / GPT
- `gpt-5.6-luna`
- `gpt-5.6-sol`
- `gpt-5.6-terra`
- `gpt-6-astra`
GPT se puede usar con el [SDK de OpenAI](/es/docs/quickstart-openai-sdk/) y con el [CLI de Codex](/es/docs/quickstart-codex/). La interfaz y el método de facturación de cada modelo se rigen por el [catálogo de modelos de la consola](https://1zheai.com/model-catalog?lng=es).
## Modelos MiMo
Los IDs, las interfaces compatibles y las unidades de facturación de los modelos de texto y voz de MiMo se encuentran en [modelos y precios](https://1zheai.com/en/pricing/). El texto se factura por token y la voz por la unidad de facturación del modelo correspondiente; no apliques las reglas de caché y descuento de Claude.
## Consultar la lista más reciente con la interfaz
Los modelos se añaden o eliminan según las publicaciones oficiales; la respuesta de la interfaz es la fuente de verdad:
```bash title="用你的 Key 查"
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-你的Key"
```
```bash title="公开价格接口（不需要 Key）"
curl -s https://1zheai.com/api/pricing | jq -r '.data[].model_name'
```
## Cómo elegir
Si no sabes cuál elegir, puedes empezar así:
| Escenario | Recomendación |
|---|---|
| Programación diaria, uso principal en Claude Code | `claude-sonnet-5-5` |
| Refactorizaciones complejas, problemas difíciles de depurar | `claude-opus-5-5` |
| Subtareas, resúmenes, clasificación y otras tareas ligeras | `claude-haiku-5-5` |
Para ver cómo mapear los tres niveles opus / sonnet / haiku a modelos concretos en Claude Code, consulta [integración con Claude Code](/es/docs/quickstart-claude-code/).
## Preguntas frecuentes
Primero verifica la ortografía del ID y el sufijo de fecha, y luego usa el `/v1/models` anterior para confirmar que tu clave de API (API key) puede ver este modelo. Los nombres de modelo personalizados de otros proveedores (por ejemplo, con prefijos o sufijos añadidos) no se pueden usar aquí.
Cuando el modelo no existe o no está disponible en ese momento, la pasarela devuelve HTTP 404. En la respuesta nativa de Anthropic, el `error.type` es `not_found_error`; en la respuesta compatible con OpenAI, el `error.code` es `model_not_found`.
Primero verifica el ID y la lista de modelos disponibles de la clave; no reintentes repetidamente el mismo ID incorrecto. Solo se puede devolver 503 cuando el modelo existe pero no hay un servicio upstream saludable en ese momento; consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).
En condiciones normales, el `model` de la respuesta es el ID que solicitaste. Si no coincide, envía la hora de la solicitud y la respuesta a support@1zheai.com; también puedes seguir el proceso de [verificar modelo y uso](/es/docs/verify-model/).
## Modelos de imágenes y consulta de interfaces
El catálogo público, actualizado el 2026-10-16, incluye `gpt-image-1.5` y `chatgpt-image-latest`. Consulta [integración de generación de imágenes](/es/docs/api-images/) para más detalles; los permisos y parámetros reales dependen de tu clave y del catálogo de modelos.
Para ver los ejemplos completos de la API de modelos, los dos formatos de respuesta y el método de solución de problemas cuando la lista está vacía, consulta [API para consultar modelos disponibles](/es/docs/api-models/).
---
# Migrar desde otros servicios a 1折AI
Source: https://1zheai.com/es/docs/migration/
Markdown: https://1zheai.com/es/docs/migration.md
---
title: "Migrar desde otros servicios a 1折AI"
description: "Migra paso a paso por dirección, clave, modelo, protocolo y funciones, conservando la configuración original para poder volver atrás."
headingIds: {"Verifica estas cuatro configuraciones juntas":"section-1","Verifica en orden":"section-2","Alcance de las variables de entorno":"section-3","Vuelve atrás si el cambio falla":"section-4"}
---
Guarda la configuración original antes de migrar. Primero verifica en un terminal o entorno de desarrollo separado; confirma que funciona correctamente antes de cambiar tus herramientas habituales o servicios en producción.
## Verifica estas cuatro configuraciones juntas
| Configuración | Forma en 1折AI | Omisiones comunes |
| --- | --- | --- |
| OpenAI Base URL | `https://1zheai.com/v1` | Escribir de más `/chat/completions`, u omitir `/v1` |
| Anthropic Base URL | `https://1zheai.com` | El SDK agrega una vez más `/v1` |
| Clave API | Clave creada en la consola de este sitio | Reutilizar la clave del proveedor anterior |
| ID del modelo | ID completo devuelto por `/v1/models` de este sitio | Reutilizar nombres con prefijo `vendor/` o sufijo personalizado |
Las solicitudes HTTP originales requieren la ruta completa del endpoint; los SDK y las herramientas de escritorio normalmente solo requieren la Base URL. Consulta [el tutorial correspondiente a la herramienta](/es/docs/integrations/).
## Verifica en orden
Realiza una llamada según [la interfaz de consulta de modelos](/es/docs/api-models/). Si falla, primero corrige la dirección, las credenciales o las condiciones de acceso; no ajustes varios parámetros de negocio a la vez.
Elige [Chat Completions](/es/docs/api-chat-completions/), [Responses](/es/docs/api-responses/) o [Messages](/es/docs/api-messages/). Mantén el protocolo que requiere tu cliente original y elimina primero los parámetros opcionales.
Verifica secuencialmente el streaming, el historial de múltiples turnos, las llamadas a herramientas y las demás capacidades necesarias. Agrega una sola función cada vez y conserva las respuestas de error para comparar. Que el texto normal funcione no significa que los archivos, la búsqueda y los modelos auxiliares de un Agent sean todos compatibles.
Confirma la hora de la solicitud y el modelo en [el registro de llamadas](/es/docs/usage-logs/). Reinicia los terminales, IDE o servicios en segundo plano que necesiten recargar la configuración para evitar que sigan usando las variables de entorno antiguas.
## Alcance de las variables de entorno
`export` en el terminal solo afecta al shell actual y a los procesos hijos iniciados después. Las aplicaciones de escritorio, los contenedores, las tareas programadas y los servicios del sistema pueden usar otro conjunto de entorno; configura las credenciales donde realmente se ejecute el programa.
Los campos con el mismo nombre en los archivos de configuración también pueden sobrescribir las variables de entorno. Herramientas como Claude Code y Codex tienen sus propios tutoriales; no acumules todas las variables de proveedores en la configuración global del shell.
## Vuelve atrás si el cambio falla
Restaura la configuración de proveedor, dirección y modelo guardada anteriormente y reinicia el cliente. Si estás migrando un negocio en producción, verifica primero con una pequeña cantidad de solicitudes y luego amplía el alcance; conserva el método de conmutación de configuración a nivel de aplicación para facilitar la recuperación del servicio.
Si no estás seguro de si una función está habilitada, consulta el catálogo de modelos o contacta con soporte. No asumas que este sitio ofrece los mismos servicios que otras plataformas solo porque esas ofrezcan Embeddings, Batch o algún modelo de imagen propietario.
---
# Preguntas frecuentes sobre el acceso a la API
Source: https://1zheai.com/es/docs/faq/
Markdown: https://1zheai.com/es/docs/faq.md
---
title: "Preguntas frecuentes sobre el acceso a la API"
description: "Encuentre rápidamente respuestas a preguntas frecuentes sobre la URL base, los modelos, el streaming, los clientes, los tiempos de espera y la monitorización de disponibilidad."
headingIds: {"Dirección, claves y modelos":"section-1","Solicitudes y clientes":"section-2","Estado del servicio y ayuda":"section-3"}
---
## Dirección, claves y modelos
Para el SDK de OpenAI, complete `https://1zheai.com/v1`; para el SDK de Anthropic y Claude Code, complete `https://1zheai.com`. Al usar curl directamente, complete la ruta completa de la solicitud. Algunas herramientas de escritorio completan automáticamente la ruta; consulte la [tabla de correspondencia de direcciones ](/es/docs/base-url/).
Sí. El acceso a este sitio utiliza una clave API creada en la consola de este sitio; la suscripción de los clientes de consumo y las credenciales de la API de este sitio son formas de acceso distintas. La herramienta también debe admitir proveedores o direcciones API personalizados.
La lista muestra los modelos visibles para la clave actual, no la tasa de éxito de inferencia en tiempo real. También debe verificar el protocolo de la interfaz, los parámetros opcionales y el estado del proveedor upstream; consulte la [interfaz de consulta de modelos ](/es/docs/api-models/).
Copie el ID completo desde la lista de modelos de este sitio. Diferentes proveedores pueden usar prefijos, alias y versiones por fecha distintos; no cambie los nombres por conjetura. Los pasos de migración se encuentran en la [guía de migración ](/es/docs/migration/).
## Solicitudes y clientes
Primero confirme el protocolo de respuesta. Chat Completions lee `choices[].message.content`, Messages recorre los bloques de texto de `content`, Responses recorre `output` o usa el `output_text` del SDK. Las respuestas de llamadas a herramientas también pueden no contener texto normal.
Las conversaciones de múltiples turnos requieren que el cliente envíe el historial. Reutilizar la misma clave no crea automáticamente una sesión en el servidor. Las extensiones relacionadas con sesiones de Responses deben confirmarse por separado; no dependa de ellas por defecto.
También es necesario confirmar el evento de finalización o el estado final. Pueden ocurrir errores a mitad de camino, interrupciones del flujo y truncamiento de la salida después de haber recibido ya parte del texto. Consulte [salida en streaming ](/es/docs/streaming/) para más detalles.
No se recomienda. El tiempo de espera puede agotarse después de que la solicitud ya haya sido procesada. Primero consulte los registros de llamadas y luego ejecute reintentos con un número limitado de intentos, retroceso y tiempo total de espera, evitando que tanto el SDK como la aplicación realicen cada uno una ronda de reintentos. Consulte [tiempos de espera y reintentos ](/es/docs/retries/).
No compile la clave en scripts de navegador ni en repositorios públicos. Mantenga las credenciales en su servidor y llame a la interfaz desde allí; el navegador solo debe conectarse a su propio backend. Las variables de entorno en el código de demostración están destinadas al servidor o a la terminal local.
## Estado del servicio y ayuda
La monitorización comprueba la accesibilidad HTTP del sitio oficial, la consola y la entrada de la API; no representa la tasa de éxito de inferencia de cada modelo. La monitorización y la aplicación se despliegan en el mismo servidor; en caso de fallo del equipo completo, la monitorización también se detendrá; los datos históricos se acumulan a partir de la activación.
Proporcione la hora y la zona horaria del incidente, la versión del cliente, el ID del modelo, la ruta completa de la solicitud, el código de estado HTTP, el ID de solicitud y la información de error despersonalizada. Elimine las claves, las cabeceras de autenticación y el contenido de conversaciones privadas; puede organizar la información según la [plantilla de resolución de problemas ](/es/docs/troubleshooting/).
---
# Guía de compra de la tienda
Source: https://1zheai.com/es/docs/store-guide/
Markdown: https://1zheai.com/es/docs/store-guide.md
---
title: "Guía de compra de la tienda"
description: "Conoce las diferencias entre cuentas listas para usar, recargas de suscripción y tarjetas de regalo, realiza pedidos según las instrucciones del producto y haz seguimiento de la entrega."
headingIds: {"Verificar antes de pedir":"section-1","Pedido y entrega":"section-2","Debes conocer antes de comprar":"section-3","Invita a amigos a comprar":"section-4"}
---
Elige una cuenta de IA, un servicio de suscripción o una tarjeta regalo en la tienda. Revisa la descripción del producto antes de hacer el pedido.
| Qué necesitas | Servicio a elegir | Dónde verlo |
| --- | --- | --- |
| Invocar modelos en código o herramientas | API de modelos | [Inicio rápido de la API](/es/docs/quickstart/) |
| Comprar una cuenta de terceros existente | Cuenta terminada | [Compra y uso de cuentas listas para usar](/es/docs/account-guide/) |
| Activar membresía en tu propia cuenta de terceros | Recarga de suscripción | [Condiciones y proceso de recarga](/es/docs/subscription-guide/) |
| Obtener códigos o enlaces de canje | Tarjeta de regalo | [Instrucciones de canje y uso](/es/docs/gift-card-guide/) |
Las claves API de este sitio no pueden iniciar sesión en ChatGPT, Claude o Grok; comprar una membresía de plataforma de terceros tampoco equivale a recargar el saldo de la API de este sitio.
## Verificar antes de pedir
Revisa el nombre del producto, especificaciones, región, duración de la suscripción, stock actual, método de entrega y las instrucciones de compra. Las especificaciones que no se muestran en el catálogo o no están disponibles para compra aún no están abiertas; no pagues siguiendo el flujo de páginas de demostración u otros comerciantes.
Si el producto admite renovación, cambio de correo, uso por múltiples personas o un cliente específico, rige la descripción del producto seleccionado. Si no se indica claramente, contacta primero con soporte para confirmarlo; no se asume por defecto que incluye estas capacidades.
## Pedido y entrega
1. En la[tienda en línea](https://1zheai.com/en/store/)selecciona el producto y las especificaciones.
2. Después de iniciar sesión, verifica el precio de liquidación, la cantidad y las instrucciones de compra. Los productos de recarga requieren además completar los datos solicitados en el formulario.
3. Lee las reglas de riesgo y posventa, marca activamente la confirmación y realiza el pedido; el pedido se paga con el saldo de la billetera de este sitio.
4. En[Mis pedidos](https://1zheai.com/store-orders?lng=es)consulta el estado, el contenido de entrega o los datos que debas complementar. Que la recarga de saldo se haya completado con éxito no significa que el producto haya sido comprado o que la recarga haya finalizado.
Los productos de entrega automática con stock, los productos de entrega manual y las recargas activadas tras el pedido se procesan de forma diferente. No se promete de manera uniforme la entrega instantánea ni un plazo fijo de finalización; rige lo mostrado en la página de liquidación y en el pedido.
## Debes conocer antes de comprar
Después de que una cuenta lista para usar se entregue normalmente o la recarga se complete con éxito, si la cuenta es bloqueada por la plataforma de terceros, no se reembolsa por el bloqueo. Podemos ayudar con la apelación, pero no prometemos el resultado del desbloqueo. Si no se entrega según lo acordado, la recarga no tiene éxito o legalmente corresponde responsabilidad a este sitio, se gestionará según las reglas de posventa correspondientes.
[Reglas de transacción y posventa](/es/docs/store-rules/) · [Resolución de problemas de pedidos](/es/docs/store-orders/)
## Invita a amigos a comprar
Los productos de la tienda pueden participar en comisiones según las especificaciones. El alcance de participación, la atribución y las condiciones de liquidación se detallan en[Recompensas de invitación y comisiones de la tienda](/es/docs/affiliate-guide/).
---
# Compra y uso de cuentas listas para usar
Source: https://1zheai.com/es/docs/account-guide/
Markdown: https://1zheai.com/es/docs/account-guide.md
---
title: "Compra y uso de cuentas listas para usar"
description: "Especificaciones, contenido de la entrega, primer inicio de sesión y riesgos de baneo que debes confirmar antes de comprar cuentas de ChatGPT, Claude y Grok ya preparadas."
headingIds: {"Confirmar antes de la compra":"section-1","Después de recibir la cuenta":"section-2","Uso diario y renovación":"section-3","Baneos y servicio de atención posventa":"section-4"}
---
Una cuenta lista para usar entrega una cuenta de una plataforma de terceros tal como se describe en la ficha del producto seleccionado. Si se incluye una suscripción, el nivel de la suscripción y la duración restante, todo ello lo determina dicho producto y el pedido; no lo juzgues solo por el nombre de la plataforma.
## Confirmar antes de la compra
- Si se incluye una suscripción, y el nivel específico (por ejemplo Pro, Max) y la duración; las especificaciones que no se muestran no están disponibles para la venta.
- Región, método de inicio de sesión y contenido de la entrega; si se proporciona acceso al correo, recepción de códigos de verificación o capacidad de cambiar el correo.
- Si es una entrega única o tiene arreglos de renovación separados; no asumas que se incluyen renovación automática, reenvío de correos o recordatorios de renovación.
- Si se permite el uso en equipo, compartido o transferido, así como los propios términos de la plataforma de terceros y las restricciones regionales.
## Después de recibir la cuenta
1. En [Mis pedidos ](https://1zheai.com/store-orders?lng=es) verifica el producto, las especificaciones y la información de entrega, y guarda el número de pedido en un lugar seguro.
2. Sigue las instrucciones de inicio de sesión de ese producto para acceder a la plataforma correspondiente, y comprueba si la cuenta puede iniciar sesión, su nivel de suscripción y su período de vigencia.
3. Cambia la contraseña, recupera la información o activa la verificación de seguridad de la manera permitida por el producto; para los elementos que no se pueden cambiar, contacta primero con soporte para confirmarlo.
4. Si la información entregada no es válida, las especificaciones no coinciden o el inicio de sesión falla, conserva capturas de pantalla con datos ocultos y mensajes de error, y explica la situación a través del canal de soporte del sitio web oficial. No compartas públicamente contraseñas de cuentas, códigos de verificación ni códigos de recuperación.
## Uso diario y renovación
Cumple con los términos de uso de la plataforma. La cuenta puede estar sujeta a restricciones regionales, de volumen de uso, de verificación de identidad o de control de riesgos; la compra no incluye ninguna garantía de eludir restricciones, gestionar la verificación de identidad en tu nombre ni de que nunca serás baneado. La verificación de identidad debe completarla el usuario real según lo requiera la plataforma; no envíes documentos de identidad ni códigos de verificación a atención al cliente a menos que exista otro proceso legítimo explícito y necesario.
Cuando sea necesario renovar, confirma primero el método admitido por el producto actual; no apliques recargas destinadas a tu propia cuenta directamente a una cuenta lista para usar, y no apiles suscripciones incompatibles por tu cuenta.
## Baneos y servicio de atención posventa
Después de que una cuenta lista para usar haya sido entregada normalmente o de que una recarga haya tenido éxito, si la cuenta es baneada por la plataforma de terceros, no se emite reembolso debido al baneo. Podemos ayudar con una apelación, pero no prometemos un resultado de desbaneo. El incumplimiento de la entrega acordada, una recarga sin éxito o las situaciones en las que este sitio deba responsabilizarse según la ley se gestionan de acuerdo con las correspondientes reglas de atención posventa.
[Reglas detalladas de transacción ](/es/docs/store-rules/) · [Solución de problemas de pedidos ](/es/docs/store-orders/)
---
# Condiciones y proceso de recarga de suscripción
Source: https://1zheai.com/es/docs/subscription-guide/
Markdown: https://1zheai.com/es/docs/subscription-guide.md
---
title: "Condiciones y proceso de recarga de suscripción"
description: "Compruebe la elegibilidad, la información requerida, las notas de seguridad y el manejo de pedidos antes de recargar con su propia cuenta."
headingIds: {"Compruebe primero las condiciones de la cuenta":"section-1","Proceso de pedido":"section-2","Seguridad de la información":"section-3","Procesamiento, fallos y reembolsos":"section-4"}
---
La recarga de suscripción activa la membresía seleccionada para su cuenta existente en la plataforma de terceros; no se entrega ninguna cuenta nueva. La disponibilidad de un producto para la venta, así como las plataformas y niveles admitidos, está sujeta a lo que [la tienda](https://1zheai.com/en/store/) muestre actualmente. Este documento no indica que todas las plataformas o especificaciones estén abiertas.
## Compruebe primero las condiciones de la cuenta
Revise la región, el tipo de cuenta, el estado actual de la suscripción, el saldo pendiente, el historial de reembolsos y las restricciones de renovación requeridas por el producto seleccionado. Las condiciones pueden variar según el canal; no exigimos uniformemente que todas las cuentas sean Free, ni garantizamos uniformemente que sea posible apilar, mejorar o extender una suscripción existente.
Si ya tiene una suscripción, saldo pendiente, restricciones de la plataforma, o no está seguro de la elegibilidad de la cuenta, contacte primero con soporte. No realice pedidos repetidamente para probar, y no sustituya las instrucciones de operación de otro comerciante por las notas del producto de este sitio.
## Proceso de pedido
1. Seleccione la especificación concreta y confirme el precio, la duración, la cuenta aplicable y el método de activación.
2. Complete la información requerida por esa especificación en el formulario de pago de este sitio, como el identificador de cuenta o el Organization ID; los campos varían según el producto.
3. Verifique la cuenta de destino y la información, lea el aviso de riesgo y envíe el pedido.
4. Compruebe el progreso del procesamiento en [Mis pedidos](https://1zheai.com/store-orders?lng=es). Actualice la información solo cuando el pedido original indique que se puede corregir; no vuelva a comprar.
5. Una vez que el pedido muestre la finalización, inicie sesión en la plataforma de terceros para comprobar el nivel de membresía y el período de validez; si aún aparece como no actualizado, actualice o vuelva a iniciar sesión y vuelva a comprobar, y contacte con soporte si sigue sin coincidir.
## Seguridad de la información
Algunas especificaciones pueden requerir información de sesión de inicio de sesión como Session JSON. Este tipo de información puede permitir el acceso a su cuenta y es tan sensible como una contraseña. Envíela únicamente a través del formulario dedicado correspondiente al pedido en este sitio; no la envíe a chat en línea, correo electrónico, capturas de pantalla públicas o sitios web de terceros para consultar cuentas. Envíela solo después de comprender el alcance de la autorización y aceptar los requisitos del producto; si no puede aceptarlos, no compre esa especificación.
No envíe contraseñas, códigos de verificación, claves API ni sesiones de inicio de sesión completas en mensajes ordinarios de atención al cliente. Una vez finalizado el procesamiento, compruebe y gestione los dispositivos y sesiones de inicio de sesión utilizando los métodos proporcionados por la plataforma de terceros.
## Procesamiento, fallos y reembolsos
El procesamiento comienza después del pago; una vez en la etapa de procesamiento, no se puede cancelar directamente. Un aviso de tiempo de espera o fallo no significa un reembolso, ni implica necesariamente que la activación no se haya producido. Conserve el pedido original, espere a que el estado se actualice o contacte con soporte para verificar, y evite cargos duplicados o activaciones duplicadas. Los resultados y destinos de los reembolsos están sujetos a los registros de pedido y billetera de este sitio; no prometemos que los reembolsos siempre se devuelvan a través del método de pago original.
Después de que una cuenta lista para usar se entregue normalmente o de que la recarga tenga éxito, si la cuenta es baneada por la plataforma de terceros, no se emitirá reembolso debido al baneo. Podemos ayudar con las apelaciones, pero no prometemos un resultado de desbaneo. El incumplimiento de la entrega acordada, la recarga fallida o las situaciones por las que este sitio deba responder legalmente se gestionan según las reglas de posventa correspondientes.
[Reglas de transacción y posventa](/es/docs/store-rules/) · [Solución de problemas de pedidos](/es/docs/store-orders/)
---
# Aviso de canje de tarjetas de regalo
Source: https://1zheai.com/es/docs/gift-card-guide/
Markdown: https://1zheai.com/es/docs/gift-card-guide.md
---
title: "Aviso de canje de tarjetas de regalo"
description: "Verifique la región, el período de vigencia, las cuentas elegibles y las reglas de entrega de la tarjeta antes de la compra y el canje."
headingIds: {"Confirmar antes de la compra":"section-1","Cómo usar después de recibir":"section-2","Cancelación y servicio posventa":"section-3"}
---
Las tarjetas de regalo se entregan como un código de canje o un enlace de canje; las recargas de suscripción, en cambio, pueden activarse directamente a través del proceso del pedido. Se trata de dos métodos de entrega diferentes: no todas las recargas deben entenderse como la recepción de un código de tarjeta para canjearlo posteriormente en un sitio externo.
## Confirmar antes de la compra
Verifique la plataforma, la región, la moneda o valor facial, el nivel de suscripción, el período de vigencia y las condiciones de cuenta elegibles indicados en el producto. Si se admiten suscripciones existentes, suscripciones móviles, canjes acumulados o regalos, debe revisarlo punto por punto en la descripción del producto; no trate los períodos de vigencia ni las condiciones de canje de otros comerciantes como compromisos de este sitio.
Cuando la tienda no tenga tarjetas de regalo disponibles para la compra, esto significa que las compras no están abiertas en este momento. Cuando cambien las reglas de la plataforma o el estado de suministro, prevalecerá la visualización real del producto.
## Cómo usar después de recibir
1. Verifique el contenido entregado en [Mis pedidos ](https://1zheai.com/store-orders?lng=es); no comparta públicamente el código de canje ni capturas de pantalla que lo contengan.
2. Confirme que ha iniciado sesión en la cuenta de destino correcta y luego acceda al punto de canje designado según la descripción del producto; tenga cuidado con sitios web desconocidos que soliciten transferencias adicionales o contraseñas.
3. Vuelva a verificar la región y el estado de la cuenta antes de canjear, y confirme los beneficios acreditados realmente después del canje.
4. Si encuentra un código ya utilizado, un código inválido, una discrepancia de región o beneficios no acreditados, conserve el número de pedido, el contenido del error y las capturas de pantalla censuradas, y contacte con soporte; no vuelva a comprar para solucionar el problema.
## Cancelación y servicio posventa
Los pedidos que aún no hayan comenzado a procesarse pueden cancelarse a través del punto de acceso proporcionado con el pedido; no se admiten reembolsos directos después de haber entregado un código de canje. Para cualquier problema, contacte con soporte para su verificación. Los casos de no entrega según lo acordado, entrega inválida o situaciones por las que este sitio tenga responsabilidad legal se gestionarán según las reglas de servicio posventa aplicables. Las prohibiciones de tarjetas de regalo, las restricciones de canje y las condiciones de reembolso se rigen por el aviso específico de ese producto; las reglas de reembolso de saldo de API no se aplican.
[Reglas de transacción y servicio posventa ](/es/docs/store-rules/) · [Solución de problemas de pedidos ](/es/docs/store-orders/)}
---
# Estados de pedido y solución de problemas
Source: https://1zheai.com/es/docs/store-orders/
Markdown: https://1zheai.com/es/docs/store-orders.md
---
title: "Estados de pedido y solución de problemas"
description: "Busca el contenido entregado, el progreso del procesamiento, las correcciones de datos y los registros de reembolso, y evita pedidos duplicados."
headingIds: {"Explicación de estados":"section-1","Preguntas frecuentes":"section-2","Se realizó el cargo, pero no recibí la cuenta o la membresía":"section-3","Los datos se rellenaron incorrectamente":"section-4","El pedido muestra completado, pero la plataforma aún no tiene la membresía":"section-5","La cuenta fue suspendida o se requiere verificación de identidad":"section-6","¿Dónde está el reembolso?":"section-7","¿Qué debo proporcionar al contactar con soporte?":"section-8"}
---
En[Mis pedidos](https://1zheai.com/store-orders?lng=es)selecciona el pedido correspondiente. Los registros de compra, el contenido entregado y el progreso del procesamiento se basan en ese pedido; los registros de recarga de saldo no son pedidos de productos.
## Explicación de estados
| Estado | Qué significa | Siguiente paso |
| --- | --- | --- |
| Pendiente de entrega | El pedido se ha creado, pero aún no se ha completado la entrega | Revisa el método de entrega y las instrucciones del pedido; si se ofrece una opción de cancelación, puedes solicitarla |
| En proceso | Se está procesando manualmente o se está abriendo en un canal asociado | Conserva el pedido original, no compres de nuevo; añade o corrige los datos según las indicaciones |
| Entregado | Se ha proporcionado el contenido entregado o el resultado de la apertura | Para cuentas listas para usar, verifica el inicio de sesión y las especificaciones; para recargas, verifica la membresía; para tarjetas de regalo, canjea según las instrucciones |
| Cancelado | El pedido original se ha terminado | Verifica el motivo de la cancelación y el flujo de la billetera; si hay reembolso o no depende de los registros reales |
El progreso detallado de la recarga puede indicar espera de suministro, espera de apertura, datos que necesitan corrección o reembolso en proceso. Este progreso es diferente del estado final de finalización; no juzgues el resultado de la apertura o el reembolso solo por un error puntual.
## Preguntas frecuentes
### Se realizó el cargo, pero no recibí la cuenta o la membresía
Primero abre los detalles del pedido para verificar el estado y el contenido entregado. La entrega manual y la recarga no siempre se completan de inmediato; si se supera el plazo indicado en la descripción del producto, el estado no se actualiza durante mucho tiempo o muestra anomalías, contacta con soporte y no repitas el pago.
### Los datos se rellenaron incorrectamente
Actualiza solo cuando el pedido original muestre una opción de corrección, verifica la cuenta de destino y envía. Si no hay opción o ya está entregado, contacta primero con soporte; no se promete que se pueda transferir una suscripción ya activada.
### El pedido muestra completado, pero la plataforma aún no tiene la membresía
Confirma que has iniciado sesión en la cuenta de destino enviada, actualiza o vuelve a iniciar sesión y revisa la configuración de la suscripción. Si aún no coincide, conserva una captura con datos ocultos y el número de pedido y contacta con soporte; no compres otro pedido por tu cuenta.
### La cuenta fue suspendida o se requiere verificación de identidad
Apela o verifica por los canales oficiales de la plataforma de terceros. Después de una entrega normal o una recarga exitosa, no se reembolsa por suspensión de la cuenta; podemos ayudar con la apelación, pero no se garantiza la reactivación. Las anomalías como la falta de entrega según lo acordado se manejan por separado según[las reglas de posventa](/es/docs/store-rules/).
### ¿Dónde está el reembolso?
Revisa el motivo de la cancelación del pedido y el flujo de la billetera. El saldo devuelto a la billetera es diferente de un reembolso al método de pago original; un reembolso que muestra estar en proceso aún no se ha completado, no repitas la misma solicitud.
### ¿Qué debo proporcionar al contactar con soporte?
Número de pedido, producto y especificaciones, hora y zona horaria del incidente, estado del pedido, información de error con datos ocultos. No envíes contraseñas, códigos de verificación, Session JSON completo, códigos de canje ni claves API.
---
# Reglas de transacciones y servicio postventa de la tienda
Source: https://1zheai.com/es/docs/store-rules/
Markdown: https://1zheai.com/es/docs/store-rules.md
---
title: "Reglas de transacciones y servicio postventa de la tienda"
description: "Distingue por etapa de pedido la cancelación, anomalías de entrega, fallos de activación y bloqueo de cuenta; el saldo de la API de modelos se gestiona según las reglas de recarga."
headingIds: {"Información antes de realizar el pedido":"section-1","Cancelación y reembolso según la etapa del pedido":"section-2","El riesgo de bloqueo debe entenderse por separado":"section-3","Diferencia con el reembolso de saldo de API":"section-4","Cuando necesite servicio postventa":"section-5"}
---
## Información antes de realizar el pedido
El precio, las especificaciones, la cantidad, la región, la duración, el método de entrega y las notas de riesgo se mostrarán en el producto o en el proceso de pago. Léalos por completo antes de confirmar; si hay condiciones poco claras, contacte primero con soporte. El pedido conserva las especificaciones y notas de riesgo confirmadas en el momento de la compra; las actualizaciones posteriores de las páginas no modifican el registro de confirmación de pedidos históricos.
Este sitio es su punto de entrada para comprar productos y solicitar servicio postventa. Cuando intervengan socios de suministro, este sitio gestiona la verificación según el pedido; no pague por separado a proveedores desconocidos ni necesite registrar una cuenta de distribución por su cuenta.
## Cancelación y reembolso según la etapa del pedido
| Situación | Cómo se gestiona |
| --- | --- |
| Pendiente de entrega y el pedido ofrece una opción de cancelación | Puede solicitar la cancelación desde el pedido original; tras el éxito, verifique el registro de reembolso en la cartera |
| En proceso o con resultado de activación pendiente de confirmación | No se puede cancelar directamente; conserve el pedido original a la espera de verificación y no repita la compra |
| Imposibilidad de iniciar sesión, entrega inválida o especificaciones no conformes | Proporcione el número de pedido y pruebas con datos ocultos; soporte verificará la situación de la entrega |
| Recarga fallida o datos incorrectos | Corrija según las indicaciones del pedido original o contacte con soporte; un aviso de fallo no significa que se haya reembolsado |
| Cuenta lista entregada normalmente o recarga completada con éxito, y posteriormente bloqueada por una plataforma de terceros | No se reembolsa por el bloqueo; podemos ayudar con la apelación, sin garantizar la desbloqueo |
| Tarjeta de regalo ya entregada | No se admite reembolso directo; anomalías como entregas inválidas aún pueden consultarse con soporte |
## El riesgo de bloqueo debe entenderse por separado
Tras una entrega normal de una cuenta lista o una recarga exitosa, si la cuenta es bloqueada por una plataforma de terceros, no se reembolsa por el bloqueo. Podemos ayudar con la apelación, pero no garantizamos el resultado del desbloqueo. Cuando no se haya entregado según lo acordado, la recarga no haya tenido éxito, o legalmente deba responder este sitio, se aplicarán las reglas de postventa correspondientes.
Las plataformas de terceros pueden ajustar sus términos, restringir el acceso o exigir verificación de identidad; este sitio no garantiza que no ocurran controles de riesgo, que no haya bloqueos o que la apelación sea aprobada. No confunda el bloqueo tras una entrega normal con la falta de entrega según lo acordado o el fallo de activación. Lo anterior no excluye las responsabilidades que legalmente correspondan a este sitio.
## Diferencia con el reembolso de saldo de API
El reembolso del capital no utilizado de la API de modelos se gestiona según[Recargas, reembolsos y facturas](/es/docs/billing/). Si un producto de la tienda puede cancelarse y cómo se reembolsa depende de la etapa del pedido y de las reglas del producto correspondiente; no se aplica directamente la regla de 7 días del saldo de API. La devolución a la cartera tras cancelar un pedido y el reembolso por la vía original de una recarga a la cartera son también dos operaciones distintas.
## Cuando necesite servicio postventa
Desde[Mis pedidos](https://1zheai.com/store-orders?lng=es) conserve el número de pedido y proporcione las especificaciones del producto, la hora del suceso, el estado del pedido, el estado mostrado por la plataforma de terceros y capturas de pantalla de errores con datos ocultos. Contacte a través de los canales de soporte publicados en el sitio oficial o la consola; no proporcione contraseñas, códigos de verificación, sesiones completas, códigos de canje ni imágenes originales de documentos. Para localizar un problema concreto, consulte[Troubleshooting de pedidos](/es/docs/store-orders/).
---
# Recompensas de invitación y comisiones de la tienda
Source: https://1zheai.com/es/docs/affiliate-guide/
Markdown: https://1zheai.com/es/docs/affiliate-guide.md
---
title: "Recompensas de invitación y comisiones de la tienda"
description: "Conoce la atribución de invitación de las comisiones de la tienda, los productos participantes, las condiciones de liquidación y el estado de las comisiones."
headingIds: {"Cómo participar":"section-1","Qué pedidos generan comisión":"section-2","Cuándo se liquida":"section-3","Dónde consultarlo":"section-4"}
---
Los pedidos de productos participantes pueden generar recompensas por recomendación. El administrador configura por separado cada producto de cuentas, activación de suscripciones y tarjetas regalo; no todos los productos generan comisión automáticamente.
## Cómo participar
Desde la consola, copia tu enlace de registro desde la entrada de invitación de [billetera](https://1zheai.com/wallet?lng=es). Cuando un amigo se registre a través de ese enlace, se mantiene la relación de invitación registrada por el sistema. Al realizar un pedido, la atribución de la comisión se determina según esa relación; no se cambia por hacer clic posteriormente en el enlace de otra persona, ni se envía el número de invitante en el formulario del pedido.
Los amigos que ya tienen una relación de invitación establecida y compren productos participantes en comisiones después de que la función esté activada también se procesan según las reglas de los pedidos nuevos. Los pedidos históricos anteriores a la activación de la función no recibirán comisiones de la tienda de forma retroactiva. Las compras propias no cuentan como tu propia comisión de invitación.
## Qué pedidos generan comisión
El administrador configura una comisión fija por producto según la especificación; escribir 0 indica que no participa. Las especificaciones cuya comisión real aún no esté configurada no emitirán recompensas. Al realizar el pedido se registran el invitante, el producto, la cantidad y el importe de la comisión en ese momento; los ajustes posteriores del precio o la comisión del producto no modifican los registros ya creados.
Las comisiones de la tienda y las recompensas de registro son dos tipos de registros distintos. Que un amigo recargue la billetera no equivale a comprar un producto, ni genera automáticamente una comisión de la tienda. La emisión de la recompensa de registro se rige por la configuración existente de recompensas de invitación del administrador.
## Cuándo se liquida
| Situación del pedido | Tratamiento de la comisión |
| --- | --- |
| Pendiente de entrega, en proceso o con resultado de activación por confirmar | Solo se registra la comisión estimada; no se puede transferir al saldo |
| Entrega exitosa de cuenta lista para usar o tarjeta de regalo, recarga completada | El sistema la liquida y la acredita en el saldo de recompensas |
| Pedido cancelado y reembolsado | La comisión estimada queda anulada; no se emite recompensa |
| Envío duplicado del pedido o notificación de finalización procesada dos veces | Un mismo pedido se liquida una sola vez |
Un error o tiempo de espera en el pedido no significa que se haya entregado; no se puede determinar si se generó comisión basándose únicamente en un resultado de procesamiento. Las prohibiciones ocurridas después de una entrega normal de la cuenta o de una recarga exitosa se gestionan según las [reglas de posventa de la tienda](/es/docs/store-rules/).
Si la cuenta receptora de la recompensa está deshabilitada o ha alcanzado el límite de importe del sistema, la comisión permanece en estado pendiente de liquidación y se reintenta cuando se restablezcan las condiciones; esto no afecta la entrega del pedido del comprador. Cuando el pago del sistema y la función de recompensas están suspendidos, la liquidación también se suspende.
## Dónde consultarlo
En la billetera, "Comisiones recientes de la tienda" muestra el producto, la especificación, la cantidad, el importe y el estado de los pedidos participantes recientes:
- **Pendiente de liquidación**: importe estimado, aún no incluido en las recompensas disponibles.
- **Acreditado**: ya incluido en el saldo de recompensas; no lo sumes de nuevo al calcular las recompensas disponibles.
- **Anulado**: este importe ya no generará comisión.
Las recompensas disponibles mantienen la entrada existente de transferencia al saldo y el requisito mínimo de transferencia, y pueden usarse para el consumo de la API de modelos. Las recompensas no son un límite de retiro en efectivo ni equivalen a fondos disponibles ya recargados en la tienda; la tienda sigue validando según sus propias reglas de elegibilidad de fondos.
El invitante solo puede ver los registros de comisión atribuidos a él. Los registros no muestran la identidad del comprador, el número de pedido, la contraseña de la cuenta ni los códigos de canje. Para verificar una comisión, proporciona el número de registro de comisión, el producto y la hora de ocurrencia a través de los canales de soporte publicados en el sitio oficial; no solicites los datos de acceso del comprador.
---
# Tutorial de integración de herramientas con Claude y GPT
Source: https://1zheai.com/es/docs/integrations/
Markdown: https://1zheai.com/es/docs/integrations.md
---
title: "Tutorial de integración de herramientas con Claude y GPT"
description: "Tutoriales de configuración de API y alcance de compatibilidad para Claude Code, Codex CLI, OpenCode, OpenClaw, WorkBuddy, Hermes Agent, Cursor, Cline, Cherry Studio y CC Switch."
headingIds: {"Herramientas de programación":"section-1","Asistentes de escritorio":"section-2","Más clientes y métodos de importación":"section-3","Plataformas de Agent":"section-4","Gestión de configuración":"section-5","Otras herramientas que admiten API personalizadas":"section-6","Cómo confirmar que la configuración es correcta":"section-7"}
---
Entra al tutorial según la herramienta que estés usando. Los estados siguientes se han recopilado de la documentación de integración existente y no significan que todas las versiones de las herramientas hayan sido verificadas de extremo a extremo. Después de actualizar una herramienta, vuelve a completar la verificación de llamadas de la página.
## Herramientas de programación
Integración nativa de Anthropic. Variables de entorno, archivos de configuración y preguntas frecuentes.Invocar modelos OpenAI / GPT a través de la interfaz Responses.Distingue la configuración v1 y v2, proveedor compatible con OpenAI personalizado.Integración compatible con OpenAI. Primero consulta el alcance de aplicación de las claves personalizadas y las diferencias de interfaz.Prioriza el modo Anthropic; también se ofrece la configuración OpenAI Compatible.
## Asistentes de escritorio
Añadir un proveedor personalizado en el cliente de chat.Añadir una dirección personalizada a través de la configuración del modelo; presta atención a la URL completa y al interruptor de protocolo.
## Más clientes y métodos de importación
Importar mediante enlace o JSON del portapapeles; admite configuración manual de respaldo.Código QR de proveedor para Android; el contenido de la clave está oculto de forma predeterminada.Campos de proveedor personalizados y configuración de modelos.Punto final YAML para administradores y claves independientes por usuario.Configuración de Anthropic para la extensión de VS Code.
El protocolo de un solo clic solo se usa para operaciones que el cliente ya admite públicamente. El protocolo para abrir conversaciones de ChatWise no equivale a importar una clave; LibreChat requiere configuración de administrador. No trates todas las herramientas como si fueran el mismo enlace de importación.
## Plataformas de Agent
Configurar el proveedor Anthropic personalizado y el modelo de Agent predeterminado.Configurar Chat Completions mediante el asistente de modelos o un proveedor con nombre.Los tutoriales de OpenCode, OpenClaw, WorkBuddy y Hermes Agent han sido contrastados con la configuración oficial; la verificación de extremo a extremo en este sitio aún no se ha completado. Comprueba la versión real siguiendo el tutorial y verifica las llamadas.
## Gestión de configuración
Gestiona la configuración de proveedores de Claude Code y reduce los cambios manuales.
## Otras herramientas que admiten API personalizadas
Primero comprueba si la herramienta permite configurar la dirección de la API, la clave y el ID del modelo; después elige la configuración según el protocolo:
| Protocolo admitido por la herramienta | Interfaz de este sitio | Siguiente paso |
| --- | --- | --- |
| Anthropic Messages | `/v1/messages` | Comprueba si el cliente añade automáticamente `/v1`; consulta la [explicación de la dirección](/es/docs/base-url/) |
| OpenAI Chat Completions | `/v1/chat/completions` | Normalmente, en Base URL se introduce `https://1zheai.com/v1`; excepto en los campos de punto final completos |
| OpenAI Responses | `/v1/responses` | En Base URL se introduce `https://1zheai.com/v1`; consulta [Codex CLI](/es/docs/quickstart-codex/) |
| Solo admite inicio de sesión con cuenta oficial | No usa la clave API de este sitio | Comprueba si la herramienta tiene otra configuración de proveedor personalizado |
## Cómo confirmar que la configuración es correcta
1. Elige el protocolo y Base URL según el tutorial; si cada herramienta necesita `/v1`, consulta la [tabla de comparación de direcciones](/es/docs/base-url/).
2. Selecciona un modelo disponible actualmente entre los [modelos compatibles](/es/docs/models/).
3. Realiza una solicitud breve y comprueba si la herramienta devuelve la respuesta correctamente.
4. Verifica la llamada correspondiente en el [registro de llamadas](/es/docs/usage-logs/); no juzgues por el contenido de la respuesta por qué proveedor ha procesado la solicitud.
Si encuentras problemas, consulta primero los [códigos de error y solución de problemas](/es/docs/troubleshooting/). Si escribes tu propio programa, entra en la [guía de desarrollo](/es/docs/guides/).
---
# Integración de Claude Code
Source: https://1zheai.com/es/docs/quickstart-claude-code/
Markdown: https://1zheai.com/es/docs/quickstart-claude-code.md
---
title: "Integración de Claude Code"
description: "Conecta Claude Code a 1折AI: usa ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN (variables de entorno o settings.json), con instrucciones para Windows, mapeo de modelos, extensión de VS Code y errores comunes."
headingIds: {"Ruta más corta":"section-1","Pasos completos":"section-2","Por qué usar ANTHROPIC_AUTH_TOKEN":"section-3","Mapeo de modelos":"section-4","Extensión de VS Code":"section-5","Configuraciones opcionales":"section-6","Preguntas frecuentes":"section-7"}
---
Claude Code solo necesita dos variables: `ANTHROPIC_BASE_URL` apunta a nosotros, `ANTHROPIC_AUTH_TOKEN` contiene tu clave API (API key). No necesitas iniciar sesión en una cuenta de Anthropic.
## Ruta más corta
Si ya tienes Claude Code instalado y una clave API a mano, escribe estas dos líneas en `~/.claude/settings.json` y luego ejecuta `claude`:
```json title="~/.claude/settings.json"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
Si el archivo ya existe, combina estos dos elementos en el `env` existente, sin sobrescribir otras configuraciones.
## Pasos completos
Si ya lo instalaste, puedes omitirlo. Los siguientes comandos provienen de [la documentación oficial de instalación de Claude Code](https://code.claude.com/docs/en/setup):
```bash title="macOS / Linux"
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell title="Windows PowerShell"
irm https://claude.ai/install.ps1 | iex
```
```bash title="Homebrew"
brew install --cask claude-code
```
```bash title="npm（需要 Node.js 22+）"
npm install -g @anthropic-ai/claude-code
```
Al instalar con npm, no agregues `sudo`.
Crea una clave API nueva en la [consola](https://1zheai.com/console?lng=es); se recomienda usar una dedicada para el Claude Code de esta máquina. Consulta [obtener y gestionar claves API](/es/docs/api-keys/).
Ubicación de settings.json: en macOS / Linux es `~/.claude/settings.json`, en Windows es `%USERPROFILE%\.claude\settings.json`.
```json title="settings.json（推荐）"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
```bash title="macOS / Linux 环境变量"
# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
```
```powershell title="Windows PowerShell"
# 持久写入当前用户，重开终端后生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")
# 只在当前窗口生效
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
```
```bat title="Windows CMD"
setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
```
`ANTHROPIC_BASE_URL` debe contener la dirección raíz; no agregues `/v1`, Claude Code añadirá `/v1/messages` por sí mismo.
Ejecuta `claude` en el directorio del proyecto y, una vez dentro, escribe `/status`. Observa dos líneas:
- La línea de la URL base muestra `https://1zheai.com`
- La línea de credenciales muestra que el origen es `ANTHROPIC_AUTH_TOKEN`
Luego haz una pregunta y revisa los [registros de llamadas](/es/docs/usage-logs/) para ver si hay un registro nuevo. Si lo hay, la conexión está establecida.
Si no quieres entrar en la interfaz interactiva, también puedes probar una vez en modo no interactivo (probado el 2026-10-15, devolvió `ok`):
```bash
claude -p "say ok" --model claude-sonnet-4-6
```
## Por qué usar ANTHROPIC_AUTH_TOKEN
Claude Code tiene dos variables donde puedes colocar la clave API; la diferencia es la siguiente ([explicación oficial](https://code.claude.com/docs/en/authentication)):
| Variable | Forma de envío | Comportamiento |
|---|---|---|
| `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | Surte efecto inmediatamente al configurarla, sin pedir confirmación |
| `ANTHROPIC_API_KEY` | `x-api-key: <值>` | En modo interactivo, la primera vez aparece un diálogo preguntando si deseas usar esta clave API |
Ambas las admitimos; se recomienda `ANTHROPIC_AUTH_TOKEN`. **Configura solo una de las dos**: si en el sistema aún queda el `ANTHROPIC_API_KEY` oficial anterior, bórralo para evitar mezclarlos y obtener un 401.
Otras dos reglas que suelen causar problemas:
- Cuando el `env` de `settings.json` y el export de la terminal configuran la misma variable, **prevalece settings.json**. Si cambiaste la variable de la terminal y no surtió efecto, revisa primero settings.json.
- No escribas la clave API en el `.claude/settings.json` del proyecto; este archivo normalmente se envía al repositorio. Para diferenciar por proyecto, usa un `.claude/settings.local.json` que no se envíe.
## Mapeo de modelos
En Claude Code, `opus`, `sonnet`, `haiku` y `fable` son alias; puedes especificar con variables de entorno el modelo concreto al que apuntan. La categoría Haiku también la usa Claude Code para ejecutar algunas pequeñas tareas en segundo plano.
| Variable | Función | Valor de ejemplo |
|---|---|---|
| `ANTHROPIC_MODEL` | Modelo usado al iniciar | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Modelo al que apunta el alias `opus` | `claude-opus-5-5` |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Modelo al que apunta el alias `sonnet` | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Modelo para el alias `haiku` y las tareas en segundo plano | `claude-haiku-5-5` |
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Modelo al que apunta el alias `fable` | `claude-fable-5-1` |
```json title="~/.claude/settings.json（带模型映射）"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
}
}
```
El ID del modelo debe estar entre los [modelos admitidos](/es/docs/models/). Durante la ejecución también puedes cambiar temporalmente con `/model claude-opus-5-5`.
## Extensión de VS Code
La extensión de VS Code de Claude Code verifica las credenciales antes de iniciar; la recomendación oficial es escribir las variables en la configuración de usuario de VS Code (Paleta de comandos → Preferences: Open User Settings (JSON)):
```json title="VS Code settings.json"
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
]
}
```
Si solo se escriben en `~/.claude/settings.json`, la comprobación de inicio de sesión de la propia extensión podría no leerlas.
## Configuraciones opcionales
| Variable | Función |
|---|---|
| `API_TIMEOUT_MS` | Tiempo de espera de la solicitud; por defecto 600000 (10 minutos); si las tareas largas superan el tiempo de espera con frecuencia, puedes aumentarlo |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | Desactiva actualizaciones automáticas, telemetría, informes de errores y otro tráfico no esencial. Ten en cuenta que configurarla como `0` o `false` también cuenta como activada; para desactivarla debes eliminar esta variable |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | Úsalo cuando aparezca un 400 como "Extra inputs are not permitted" |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | Hace que la lista `/model` obtenga los modelos disponibles desde `/v1/models` |
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` ya se ha probado y funciona (Claude Code 2.1.296, 2026-10-15): tras iniciar, en el registro de depuración aparece `[gatewayDiscovery] cached 14 models`, y los 14 modelos coinciden con los [modelos admitidos](/es/docs/models/).
No configures `DISABLE_PROMPT_CACHING`; desactivará la caché y la factura aumentará notablemente; consulta [Prompt Caching](/es/docs/prompt-caching/).
## Preguntas frecuentes
Claude Code no leyó la clave API. Revisa la ortografía del nombre de la variable; si usas variables de entorno, confirma que se inicia en una terminal nueva; si usas settings.json, confirma que el formato JSON es correcto (una coma extra invalida todo).
La clave API se copió de forma incompleta, o `ANTHROPIC_API_KEY` y `ANTHROPIC_AUTH_TOKEN` coexisten y uno de ellos es un valor antiguo. Deja solo uno de los dos. Para más detalles, consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).
En `ANTHROPIC_BASE_URL` se escribió de más `/v1`. Cámbialo por `https://1zheai.com`.
Esto es Claude Code ejecutando pequeñas tareas en segundo plano con la categoría Haiku. Si quieres cambiarlo por otro modelo, configura `ANTHROPIC_DEFAULT_HAIKU_MODEL`.
Elimina (o comenta) las dos variables anteriores para volver al inicio de sesión oficial. Si cambias con frecuencia, usa [CC Switch](/es/docs/quickstart-cc-switch/); un clic y cambias.
No genera ninguna asociación. Al conectarte a 1折AI, Claude Code usa nuestra clave API y no inicia sesión en tu cuenta de Anthropic.
---
# Integración de Codex CLI
Source: https://1zheai.com/es/docs/quickstart-codex/
Markdown: https://1zheai.com/es/docs/quickstart-codex.md
---
title: "Integración de Codex CLI"
description: "Método de configuración para integrar OpenAI Codex CLI con 1折AI (model_providers de ~/.codex/config.toml), llamando a modelos GPT a través de la interfaz Responses."
headingIds: {"Archivo de configuración":"section-1","Instalar Codex":"section-2","Preguntas frecuentes":"section-3"}
---
Los modelos OpenAI / GPT ya están disponibles. Codex CLI utiliza la interfaz OpenAI Responses (`/v1/responses`) y se conecta mediante la clave API de este sitio. Los modelos disponibles y sus precios se encuentran en el [catálogo de modelos](https://1zheai.com/model-catalog?lng=es).
A continuación se explica claramente la configuración del proveedor personalizado de Codex; el formato proviene de la [documentación oficial de configuración de Codex](https://developers.openai.com/codex/config-reference).
## Archivo de configuración
La configuración de Codex se encuentra en `~/.codex/config.toml`. Los proveedores personalizados solo pueden escribirse en este archivo a nivel de usuario; la configuración de `.codex/config.toml` en el proyecto que establece `model_provider` será ignorada.
```toml title="~/.codex/config.toml"
model_provider = "onezhe"
model = "gpt-6-astra"
[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```
El ejemplo utiliza `gpt-6-astra`; puede reemplazarse por otros ID de modelos GPT admitidos por su clave.
Significado de cada campo:
| Campo | Descripción |
|---|---|
| `model_provider` | Qué proveedor utilizar; corresponde al id de `[model_providers.]` a continuación. `openai`, `ollama` y `lmstudio` son nombres reservados y no pueden usarse |
| `base_url` | Debe incluir `/v1` |
| `env_key` | Codex lee la clave API (API key) desde esta variable de entorno; el nombre debe coincidir exactamente con el que exporta |
| `wire_api` | La documentación oficial indica que actualmente solo admite `responses`; si se omite, se usa este valor |
A continuación, coloque la clave API en la variable de entorno:
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows PowerShell"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
```
## Instalar Codex
Los siguientes comandos provienen de la documentación oficial de Codex:
```bash title="npm"
npm install -g @openai/codex
```
```bash title="Homebrew"
brew install --cask codex
```
```bash title="macOS / Linux 脚本"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell title="Windows"
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
## Preguntas frecuentes
El nombre de variable escrito en `env_key` no coincide con el que exportó realmente, o abrió la terminal antes de configurar la variable de entorno. Verifique los nombres en ambos lados, reinicie la terminal e inténtelo de nuevo.
No. En la documentación oficial de configuración de Codex, `wire_api` solo acepta `responses`. Los servicios que solo ofrecen la interfaz Chat Completions requieren una herramienta de conversión de protocolo adicional para conectarse a Codex.
Consulte el [catálogo de modelos](https://1zheai.com/model-catalog?lng=es) para ver los modelos actuales e introduzca el ID del modelo en `model`. Después de iniciar Codex, realice una solicitud breve y verifique el modelo y el estado en el [registro de llamadas](/es/docs/usage-logs/).
---
# OpenCode integración con la API de Claude
Source: https://1zheai.com/es/docs/quickstart-opencode/
Markdown: https://1zheai.com/es/docs/quickstart-opencode.md
---
title: "OpenCode integración con la API de Claude"
description: "Tutorial de configuración de OpenCode para la API de retransmisión de 1折AI Claude, incluyendo dirección, clave y modelo, con selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Configuración de OpenCode v1":"section-1","Configuración de OpenCode v2":"section-2","Verificación de la integración y solución de problemas":"section-3","Costes y otras formas de integración":"section-4"}
---
Usa la función de proveedor personalizado de OpenCode para conectarte a 1折AI. Primero [crea una clave API ](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente ](/es/docs/models/); los ID de modelo de abajo son ejemplos, ajústalos según los permisos de tu clave.
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; completa primero una breve pregunta-respuesta y la verificación de llamadas a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos ](/es/docs/models/) para la lista de modelos y precios.
## Configuración de OpenCode v1
Según [Providers oficiales de v1 ](https://opencode.ai/docs/providers/): ejecuta `/connect`, selecciona Other, introduce el ID del proveedor `onezhe` y rellena la clave API de este sitio. Fusiona en el proyecto `opencode.json`:
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"onezhe": {
"npm": "@ai-sdk/openai-compatible",
"name": "1折AI",
"options": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
Después, en `/models` selecciona el modelo de ese proveedor. `/connect` solo guarda credenciales, no sustituye la configuración del proveedor. Aquí se selecciona explícitamente el SDK de Chat Completions; no se debe cambiar erróneamente por `@ai-sdk/openai`, que se usa para Responses. También se permite referenciar variables de entorno mediante `options.apiKey: "{env:ONEZHE_API_KEY}"`.
## Configuración de OpenCode v2
Según [Providers oficiales de v2 ](https://opencode.ai/v2/docs/providers), usa los campos nativos de v2; no se pueden mezclar con los de v1 anteriores. Fusiona en el proyecto `opencode.jsonc`:
```json
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"onezhe": {
"name": "1折AI",
"env": ["ONEZHE_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
Proporciona `ONEZHE_API_KEY` en el entorno del proceso que inicia OpenCode y luego, en `/models`, selecciona `onezhe/claude-sonnet-4-6`. La principal diferencia de v2 es `providers`, `package`, `settings`, en lugar de `provider`, `npm`, `options` de v1. Usa primero `opencode --version` para confirmar la versión mayor utilizada.
Si deseas usar Anthropic nativo, v1 permite sobrescribir `provider.anthropic.options.baseURL` oficialmente, con ejemplos que incluyen `/v1`; v2 lista `@opencode/ai/providers/anthropic-compatible`. Este tutorial sigue una configuración explícita compatible con OpenAI; no se debe cambiar el protocolo por el nombre del modelo ni prometer que la caché y las llamadas a herramientas ya estén verificadas.
## Verificación de la integración y solución de problemas
1. Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve; confirma que se puede responder; después intenta una tarea pequeña revocable y confirma por separado las llamadas a herramientas y la conversación de múltiples turnos.
3. Abre el [registro de llamadas ](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Que una respuesta de texto tenga éxito no significa que todas las capacidades de los Agentes sean compatibles.
4. Si aparece 404, comprueba que la dirección y el protocolo de este artículo coincidan; si aparece 401, comprueba el origen de la clave y si el proceso leyó las variables de entorno; si aparece 429, revisa la información de limitación de tasa antes de reintentar. Para más casos, consulta [códigos de error y solución de problemas ](/es/docs/troubleshooting/).
Las claves se guardan solo en el entorno local o en el almacén de credenciales de la herramienta; no las envíes al repositorio de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno del terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben revisarse por separado.
## Costes y otras formas de integración
Consulta los [precios en tiempo real de la API de Claude ](https://1zheai.com/en/pricing/) y las [reglas de facturación ](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas ](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo ](/es/docs/guides/).
---
# Integración con Cursor
Source: https://1zheai.com/es/docs/quickstart-cursor/
Markdown: https://1zheai.com/es/docs/quickstart-cursor.md
---
title: "Integración con Cursor"
description: "Cómo llamar a los modelos Claude de 1折AI en Cursor con una clave API de OpenAI personalizada y una URL base, y qué funciones no usan la clave API personalizada."
headingIds: {"Configuración":"section-1","Problemas conocidos":"section-2","Preguntas frecuentes":"section-3"}
---
Cursor permite configurar tu propia clave API (API key) en los ajustes, y los modelos de chat envían solicitudes con esa clave API. A continuación se explica cómo integrar 1折AI y algunas limitaciones que debes conocer antes de empezar.
Ten en cuenta estos tres puntos antes de empezar:
- Según la documentación oficial de Cursor, **la clave API personalizada solo afecta a los modelos de chat; la autocompletado con Tab siempre usa los propios modelos de Cursor**.
- Las solicitudes pasan primero por los servidores de Cursor antes de enviarse a la dirección que hayas configurado, por lo que la URL base debe ser accesible desde Internet (`https://1zheai.com/v1` funciona, pero un proxy local `localhost` no).
- El interruptor "Override OpenAI Base URL" no aparece en la documentación oficial de Cursor; la descripción de la interfaz que se muestra a continuación procede del foro de Cursor y de tutoriales de la comunidad, y puede cambiar tras una actualización de Cursor.
## Configuración
Cursor → **Cursor Settings** → **Models**, y busca la sección Keys.
```text
OpenAI API Key sk-你的Key（1折AI 的 Key）
Override OpenAI Base URL https://1zheai.com/v1
```
La URL base debe incluir `/v1`.
En la lista de modelos, haz clic en **Add model**, introduce el ID del modelo, por ejemplo `claude-sonnet-5-5`, y activa su interruptor. Los ID de los modelos se encuentran en [modelos compatibles](/es/docs/models/).
Selecciona el modelo recién añadido en el panel Chat y envía un mensaje. Cuando la respuesta funcione correctamente, comprueba la llamada en el [registro de llamadas de la consola](/es/docs/usage-logs/).
## Problemas conocidos
Hay informes en el foro de Cursor: después de configurar Override OpenAI Base URL, los modelos cuyo nombre empieza por `claude-` pueden ser tratados por Cursor como modelos de Anthropic y procesados con la clave API de Anthropic, o bien devolver un error directamente. Al elegir Claude, el ID del modelo empieza por `claude-`; si te encuentras con este problema, borra primero la clave API de Anthropic que hayas configurado en Cursor y vuelve a intentarlo.
Referencias: [publicación del foro 144899](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [publicación del foro 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).
## Preguntas frecuentes
No. Según la documentación oficial de Cursor, la autocompletado con Tab siempre usa los modelos incluidos en Cursor y no pasa por tu clave API.
Comprueba primero que la URL base incluye `/v1`. Según los informes de la comunidad, el botón Verify no siempre acepta nombres de modelos que no sean de OpenAI; puedes enviar directamente un mensaje en el Chat para probarlo, y lo que cuenta es si hay un registro en el registro de llamadas.
Los tutoriales de la comunidad indican de forma general que solo el Chat usa la clave API personalizada; funciones como Agent, Apply o Inline Edit pueden seguir usando el backend propio de Cursor. Lo que cuenta es el registro que veas realmente en el registro de llamadas.
Si tu objetivo principal es escribir código con Claude, [Claude Code](/es/docs/quickstart-claude-code/) (línea de comandos o extensión de VS Code) y [Cline](/es/docs/quickstart-cline/) ofrecen un soporte más completo para direcciones personalizadas.
---
# Integración con Cline
Source: https://1zheai.com/es/docs/quickstart-cline/
Markdown: https://1zheai.com/es/docs/quickstart-cline.md
---
title: "Integración con Cline"
description: "Integra 1折AI en el plugin Cline de VS Code: mediante Anthropic Base URL personalizado o mediante OpenAI Compatible."
headingIds: {"Método 1: Anthropic (recomendado)":"section-1","Método 2: OpenAI Compatible":"section-2","Preguntas frecuentes":"section-3"}
---
Cline es un plugin de agente de programación para VS Code. Ambos métodos permiten integrar 1折AI; se recomienda el método Anthropic, ya que las capacidades nativas de Claude (incluida la caché) son más completas.
## Método 1: Anthropic (recomendado)
Abre la configuración de Cline y selecciona **Anthropic** en **API Provider**.
- **Anthropic API Key** (introduce la clave API): `sk-你的Key`
- Marca **Use custom base URL** e introduce `https://1zheai.com` (no añadas `/v1`)
En el menú desplegable de modelos, selecciona un [modelo compatible con 1折AI](/es/docs/models/), por ejemplo `claude-sonnet-5-5`.
## Método 2: OpenAI Compatible
Selecciona **OpenAI Compatible** en **API Provider**.
| Campo | Valor |
|---|---|
| Base URL | `https://1zheai.com/v1` |
| API Key | `sk-你的Key` |
| Model ID | `claude-sonnet-5-5` |
Haz clic en **Verify** para confirmar la conexión y luego envía una pequeña tarea en Cline.
En Model Configuration puedes indicar la ventana de contexto y la longitud máxima de salida; introduce los valores correspondientes al modelo según la [documentación oficial de modelos de Anthropic](https://platform.claude.com/docs/en/about-claude/models/overview).
## Preguntas frecuentes
El método Anthropic utiliza el `/v1/messages` nativo, por lo que las capacidades de caché, thinking, etc., son las más completas; el método OpenAI Compatible utiliza `/v1/chat/completions` y destaca por su generalidad. Al usar modelos Claude, prioriza Anthropic.
La dirección del método Anthropic no debe incluir `/v1`; la dirección del método OpenAI Compatible debe incluir `/v1`. Ambos son exactamente opuestos.
---
# Integración con Cherry Studio
Source: https://1zheai.com/es/docs/quickstart-cherry-studio/
Markdown: https://1zheai.com/es/docs/quickstart-cherry-studio.md
---
title: "Integración con Cherry Studio"
description: "Añade 1折AI como proveedor personalizado en Cherry Studio, elige el endpoint Anthropic u OpenAI, e introduce la dirección raíz, la clave API y los modelos."
headingIds: {"Importación con un clic":"section-1","Configuración":"section-2","Elegir entre los endpoints Anthropic u OpenAI":"section-3","Preguntas frecuentes":"section-4"}
---
Cherry Studio es un cliente de conversación con IA para escritorio que permite añadir 1折AI como un proveedor personalizado.
## Importación con un clic
En la consola, en **Clave API → Herramientas de uso → Cherry Studio**, selecciona el protocolo Anthropic u OpenAI y haz clic en **Abrir Cherry Studio**. Tras confirmar la importación en la aplicación, obtén los modelos, habilita el proveedor y realiza una prueba. Si ya existe una configuración con el mismo nombre, revisa el aviso de sobrescritura. El enlace de importación contiene la clave completa; no lo reenvíes.
El navegador no puede confirmar si la aplicación está instalada. Si no se abre, instala y ejecuta una vez el cliente, o utiliza los pasos manuales siguientes. El formato del protocolo se ha verificado con la implementación oficial; la inferencia real debe validarse según la versión y el modelo utilizados.
## Configuración
Ajustes (icono de engranaje) → **Servicios de modelos** → **+ Añadir proveedor** al final de la lista.
| Campo | Qué introducir |
|---|---|
| Nombre del proveedor | `1折AI` |
| Clave API | `sk-你的Key` |
| Endpoint | Elige **Anthropic** (recomendado) u **OpenAI** |
| Dirección API | `https://1zheai.com` |
En la dirección API introduce solo la dirección raíz; Cherry Studio añadirá automáticamente `/v1/...` según el protocolo elegido. No pegues rutas completas como `/v1/messages` o `/v1/chat/completions`, ni añadas `#` al final (un final `#` indica que no se añadirán más rutas automáticamente).
Haz clic en **Obtener lista de modelos** y añade los modelos que vayas a usar de la lista devuelta; o haz clic en **+** e introduce manualmente el ID del modelo, por ejemplo `claude-sonnet-5-5`. Solo los modelos añadidos a la lista aparecerán en el selector de modelos de la conversación.
Activa el interruptor de habilitación en la esquina superior derecha de la página del proveedor, vuelve a la interfaz de conversación y envía un mensaje con un modelo de 1折AI.
## Elegir entre los endpoints Anthropic u OpenAI
| Endpoint | Adecuado para |
|---|---|
| Anthropic | Quiere usar capacidades nativas de Claude como extended thinking; las restricciones de protocolo del Agente se rigen por la versión actual |
| OpenAI | Está acostumbrado al formato de OpenAI o quiere gestionar de forma unificada otros servicios compatibles con OpenAI |
Ambos endpoints utilizan la misma clave API (API key) y el mismo conjunto de IDs de modelo.
## Preguntas frecuentes
Primero comprueba si la clave API tiene espacios sobrantes; después confirma que la dirección API es `https://1zheai.com` y que no contiene rutas añadidas. Si no se pueden obtener los modelos, puedes seguir usándolos introduciendo manualmente los IDs de modelo.
La dirección API se escribió como una ruta completa, o se añadió `#` al final. Cámbiala por la dirección raíz `https://1zheai.com`.
---
# Integración con Dify
Source: https://1zheai.com/es/docs/quickstart-dify/
Markdown: https://1zheai.com/es/docs/quickstart-dify.md
---
title: "Integración con Dify"
description: "Configura 1折AI mediante el plugin oficial OpenAI-API-compatible de Dify, incluyendo la configuración del modelo, la prueba de conversación y la resolución de problemas de la primera llamada."
headingIds: {"Requisitos previos":"section-1","Agregar un modelo":"section-2","Comenzar con la primera conversación":"section-3","Importar el Chatflow de ejemplo":"section-4","Resolución de problemas":"section-5","Obtener ayuda con la integración":"section-6","Alcance de la verificación":"section-7","English / Русский":"section-8"}
---
Los usuarios de Dify pueden configurar el endpoint compatible con OpenAI de 1折AI mediante el plugin oficial de modelos **OpenAI-API-compatible**. Primero verifica un modelo de texto y luego úsalo en los flujos de trabajo; no es necesario instalar plugins de terceros no verificados.
## Requisitos previos
- Un espacio de trabajo de Dify donde se puedan instalar plugins de modelos.
- Tu propia clave API de 1折AI, además de los ID de modelos que esa clave está autorizada a invocar. Consulta la [consola](https://1zheai.com/console).
- Saldo disponible suficiente en tu cuenta. La solicitud de validación al guardar un modelo y las pruebas de la aplicación pueden generar cargos normales de API.
No envíes tu clave completa al servicio de atención al cliente, ni la escribas en descripciones de flujos de trabajo, capturas de pantalla o repositorios públicos. Guárdala únicamente en el campo API Key de Dify; si usas un Dify alojado por un tercero, esa instancia almacena tu clave y reenvía las solicitudes.
## Agregar un modelo
1. En el mercado de plugins de Dify, busca **OpenAI-API-compatible** y confirma que el editor es **langgenius**.
2. Abre los proveedores de modelos en la configuración del espacio de trabajo, localiza este plugin y agrega un modelo LLM.
3. Completa los campos siguientes y guarda. Las etiquetas de la interfaz pueden variar según la versión de Dify.
| Campo | Cómo completarlo |
| --- | --- |
| Nombre del modelo | Copia el ID de modelo completo desde la consola de 1折AI; no lo sustituyas por el nombre para mostrar |
| API Key | Tu propia clave de 1折AI |
| API Base URL | `https://1zheai.com/v1` |
| Modo de finalización | `Chat` |
| Nombre del modelo en el endpoint de la API | Normalmente déjalo en blanco; si se establece, debe coincidir con el ID real del modelo |
| Tamaño de contexto del modelo | Completa según la capacidad real del modelo seleccionado; no copies la longitud de contexto de otro modelo |
Aquí necesitas `/v1`. No introduzcas el `/v1/chat/completions` completo, ni lo dupliques como `/v1/v1`. No apliques instrucciones de otros clientes que solo requieran la dirección raíz.
## Comenzar con la primera conversación
Crea una aplicación de chat en blanco, selecciona el modelo que acabas de guardar e introduce «Presenta en una frase, en chino, qué puedes hacer». Una vez confirmada una respuesta de texto completa, verifica a continuación la salida en streaming.
Consulta el tiempo de solicitud, el modelo y el resultado correspondientes en los registros de llamadas de la consola de 1折AI. No te limites a confiar en el «Guardado correctamente» de Dify como prueba de que la aplicación está conectada. Solo después del primer éxito debes configurar llamadas a herramientas, entrada visual o recuperación de la base de conocimientos; estas capacidades dependen del modelo y la interfaz concretos, y una conversación de texto exitosa no significa que todo esté disponible.
## Importar el Chatflow de ejemplo
[Descarga la plantilla de Chatflow sin clave](/es/docs/downloads/1zheai-dify-chatflow.yml) y luego, en Dify Studio, elige **Crear → Importar archivo DSL** para subirla. La plantilla es `User Input → LLM → Answer`, versión de DSL 0.7.0, y usa el plugin oficial compatible 0.0.68.
Primero agrega tus propias credenciales siguiendo los pasos anteriores. Después de importar, abre el nodo LLM y confirma que estén seleccionados tu propio proveedor y modelo, no el modelo de prueba de Dify. El ID de modelo de ejemplo es `claude-haiku-4-5-20251001`; si no está disponible para tu cuenta, cambia a un modelo al que tengas acceso y revisa la configuración de capacidades. La plantilla no contiene ninguna clave API y no proporciona créditos de llamada gratuitos.
## Resolución de problemas
| Síntoma | Qué revisar primero |
| --- | --- |
| 503 / No hay cuentas disponibles | Es posible que el upstream actual esté limitado por tasa o sin capacidad. Revisa primero el estado del servicio y los registros de llamadas, reintenta más tarde con espera exponencial o contacta con el soporte; no reintentes de forma continua a alta frecuencia ni regeneres claves repetidamente |
| 401 / Clave no válida | Si hay espacios extra, si la clave ha sido revocada y si se usó por error una clave de otra plataforma |
| 404 | Si la Base URL es exactamente `https://1zheai.com/v1`; si el ID de modelo existe |
| Modelo no permitido o saldo insuficiente | Las restricciones de modelo de la clave actual, el saldo disponible de la cuenta y el modelo seleccionado |
| Guardado correctamente, pero la aplicación no puede llamar | Si la aplicación seleccionó el proveedor y el modelo correctos; si el servidor del espacio de trabajo puede alcanzar la API |
| Las respuestas normales funcionan, pero el streaming falla | Revisa el soporte SSE del proxy, la versión del plugin y la configuración de uso de streaming; conserva un error redactado para la resolución de problemas |
| Las llamadas a herramientas o la visión fallan | Primero confirma que el modelo seleccionado admite realmente esa capacidad; evita forzarla solo alternando los interruptores del plugin |
Las solicitudes desde un Dify autoalojado las envía su servidor; el hecho de que tu navegador pueda abrir el sitio oficial no significa que el servidor de Dify pueda conectarse a la API.
## Obtener ayuda con la integración
Proporciona la versión de Dify, la versión del plugin, el ID de modelo, la marca de tiempo del error, el ID de solicitud y los detalles redactados del error a través del servicio de atención al cliente en línea del sitio oficial. No envíes la clave completa, datos de clientes ni prompts privados de tus flujos de trabajo.
## Alcance de la verificación
El 2026-10-19, con el plugin oficial 0.0.68, se completaron en Dify Cloud la conversación de texto y las llamadas en streaming de Haiku, y se contrastaron con los registros de la pasarela. El DSL sin clave exportado se importó en el mismo espacio de trabajo como una nueva aplicación. Tras la importación, una nueva prueba encontró un 503 causado por limitación de tasa del upstream, por lo que esta ronda no se registra como una ejecución posterior a la importación superada.
Esta es una prueba interna con una ventana de tiempo definida, no una garantía de disponibilidad continua. No se han verificado espacios de trabajo nuevos, versiones anteriores de Dify, llamadas a herramientas, visión ni recuperación de la base de conocimientos; completa tu primera prueba con tu propia clave limitada por tasa.
[Fuente oficial del plugin](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Mercado de plugins de Dify](https://marketplace.dify.ai/)
## English / Русский
**English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support.
**Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.
---
# Integración de WorkBuddy con la API de Claude
Source: https://1zheai.com/es/docs/quickstart-workbuddy/
Markdown: https://1zheai.com/es/docs/quickstart-workbuddy.md
---
title: "Integración de WorkBuddy con la API de Claude"
description: "Tutorial de configuración de WorkBuddy para la API de Claude de 1折AI, incluyendo dirección, clave y modelo, con selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Verificación de la integración y solución de problemas":"section-1","Costes y otras formas de integración":"section-2"}
---
Usa la función de proveedor personalizado de WorkBuddy para conectarte a 1折AI. Primero [crea una clave API ](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente ](/es/docs/models/); los ID de modelo siguientes son ejemplos, ajústalos según los permisos de tu clave.
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; realiza primero una breve prueba de preguntas y respuestas y una verificación de llamada a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos ](/es/docs/models/) para la lista de modelos y precios.
Según la [configuración oficial de modelos ](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model): Configuración → Modelos → Añadir modelo → Personalizado/Custom. Introduce la clave de este sitio y el modelo `claude-sonnet-4-6`.
Configuración con la dirección completa de la solicitud: en la configuración avanzada, activa «Protocolo personalizado», introduce la URL `https://1zheai.com/v1/chat/completions` y, tras guardar, selecciona ese modelo en el selector de modelos de la conversación. La documentación oficial indica que al activar esta opción se usa directamente la URL introducida, sin validación de ruta ni autocompletado; al desactivarla, se completará según el estándar `/chat/completions`. Por lo tanto, la URL completa y el interruptor deben describirse de forma conjunta.
El «protocolo personalizado» aquí no significa que las solicitudes OpenAI se conviertan automáticamente en solicitudes Anthropic; no puedes introducir `/v1/messages` y luego afirmar que el protocolo nativo de Claude esté conectado. Prioriza la interfaz de usuario y no proporciones formatos manuales de `models.json` no verificados. La página oficial muestra simultáneamente la ruta de configuración local actual y las instrucciones de migración del antiguo `~/.codebuddy/models.json`; evita escribir la ruta antigua como la ruta general vigente basándote en ello. Las marcas de capacidades de herramientas en la interfaz tampoco pueden sustituir la verificación de extremo a extremo en este sitio.
## Verificación de la integración y solución de problemas
1. Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve; confirma que se obtiene respuesta; después intenta una tarea pequeña reversible y confirma por separado la llamada a herramientas y la conversación de múltiples turnos.
3. Abre el [registro de llamadas ](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Una respuesta de texto exitosa no significa que todas las capacidades de los Agentes sean compatibles.
4. Si aparece 404, comprueba que la dirección y el protocolo de este artículo sean coherentes; si aparece 401, comprueba el origen de la clave y si el proceso leyó las variables de entorno; si aparece 429, revisa la información de limitación de tasa antes de reintentar. Para más casos, consulta [códigos de error y solución de problemas ](/es/docs/troubleshooting/).
Las claves solo deben guardarse en el entorno local o en el almacén de credenciales de la herramienta; no las envíes a repositorios de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno del terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben comprobarse por separado.
## Costes y otras formas de integración
Consulta los [precios en tiempo real de la API de Claude ](https://1zheai.com/en/pricing/) y las [reglas de facturación ](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas ](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo ](/es/docs/guides/).
---
# Chatbox: importación y configuración en un clic
Source: https://1zheai.com/es/docs/quickstart-chatbox/
Markdown: https://1zheai.com/es/docs/quickstart-chatbox.md
---
title: "Chatbox: importación y configuración en un clic"
description: "Importa Chatbox desde la página de API Key y verifica API Host, ruta, modelo y clave."
headingIds: {"Importación en un clic":"section-1","Portapapeles y configuración manual":"section-2","Solución de problemas":"section-3"}
---
Desde Chatbox 1.15.1 se admiten JSON de proveedor y `chatbox://provider/import`. La versión de escritorio requiere instalarse y ejecutarse una vez. En la versión web o en sistemas sin registro de protocolo, usa la importación desde el portapapeles.
## Importación en un clic
1. Abre **API Key** en la consola, busca la clave que quieras usar y entra en **Herramientas de uso → Chatbox**.
2. Selecciona el modelo de chat disponible para esta clave y pulsa **Abrir Chatbox** para permitir que el navegador abra la aplicación.
3. Confirma la importación en Chatbox y revisa la dirección del proveedor y el modelo. Si ya existe una configuración con el mismo nombre, verifica primero el alcance de la sobrescritura.
4. Envía un mensaje corto y comprueba el modelo y la hora de la solicitud en el registro de llamadas de este sitio.
## Portapapeles y configuración manual
Si la aplicación no se abre, copia **Chatbox JSON** en el mismo panel e impórtalo desde el portapapeles en la gestión de proveedores de la configuración de Chatbox. Antes de compartirlo con otros, debes eliminar `settings.apiKey`.
| Campo | Valor |
| --- | --- |
| Tipo | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | clave actual |
| Model ID | modelo de chat disponible para la clave actual |
Rellena Host y Path por separado; no añadas `/v1` a ambos campos a la vez. Si no hay modelos, obtén primero la lista de modelos o añádelos manualmente; las capacidades de imágenes, embeddings, llamadas a herramientas, etc., deben validarse por separado; no trates cualquier modelo como modelo de chat.
## Solución de problemas
- La aplicación no aparece: confirma que está instalada y se ha ejecutado, permite el protocolo en el navegador o usa la importación desde el portapapeles.
- 401 tras la importación: comprueba que la clave es válida y que no tiene espacios.
- 404: confirma que la ruta final es `/v1/chat/completions` y que no se ha concatenado dos veces.
- Modelo inexistente: usa el ID exacto de la lista de modelos; no lo deduzcas por el apodo mostrado.
Oficial: [protocolo de importación de configuración ](https://docs.chatboxai.app/guides/providers/import-config), [código fuente del cliente ](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts).
verificado con la documentación oficial el 2026-10-19. Este sitio ha implementado la generación de configuración y pruebas de regresión del frontend; no se han completado las verificaciones de inferencia real en todos los clientes, sistemas y modelos. Vuelve a verificar tras actualizar el cliente. La conexión personalizada no implica asociación oficial ni recomendación integrada.
Más: [API Key ](/es/docs/api-keys/), [lista de modelos ](/es/docs/models/), [registro de llamadas ](/es/docs/usage-logs/), [explicación de direcciones ](/es/docs/base-url/).
---
# Importación por código QR en RikkaHub
Source: https://1zheai.com/es/docs/quickstart-rikkahub/
Markdown: https://1zheai.com/es/docs/quickstart-rikkahub.md
---
title: "Importación por código QR en RikkaHub"
description: "Importar un proveedor compatible con OpenAI por código QR en RikkaHub para Android, configurar modelos y resolver problemas."
headingIds: {"Configuración por código QR":"section-1","Alternativa manual":"section-2","Resolución de problemas":"section-3"}
---
RikkaHub es un cliente de IA para Android. Este sitio utiliza su formato de compatibilidad `ai-provider:v1:` para generar un código QR local, sin recurrir a sitios web de códigos QR de terceros.
## Configuración por código QR
1. En la consola, **Clave API → Herramientas → RikkaHub**.
2. En un entorno privado, pulsa **Mostrar código QR de importación**. El código QR equivale a la clave completa; no se debe compartir capturas de pantalla.
3. En RikkaHub, **Ajustes → Ajustes del proveedor → Importar**, elige el escaneo. Si ambos extremos están en el mismo teléfono, usa la función de importar desde imagen del cliente y elimina después la captura de pantalla que contenga la clave.
4. Tras importar, obtén la lista de modelos, elige un modelo de chat, envía un mensaje breve y luego confirma en el registro de llamadas de este sitio.
5. Cuando termines, oculta el código QR. Si se envió por error a otra persona, revoca esa clave y crea una nueva.
## Alternativa manual
| Campo | Valor |
| --- | --- |
| Tipo | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Chat Completions Path | `/chat/completions` |
| API Key | Clave actual |
La importación no preconfigura capacidades del modelo ni longitud de contexto, y tampoco activa el interruptor de Responses. Cuando necesites Responses, verifica primero el modelo seleccionado y la versión del cliente, y luego valida por separado.
## Resolución de problemas
Si el escaneo falla, comprueba primero que el código QR esté completo, la pantalla sea nítida y la versión del cliente sea correcta; si aún así no funciona, usa los campos manuales. Si la lista de modelos falla, revisa la clave y la dirección; una insuficiencia de permisos no se resuelve volviendo a escanear.
Oficial: [Inicio rápido](https://github.com/rikkahub/docs/blob/main/quickstart.mdx), [Implementación del formato de compatibilidad](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt).
verificado con el protocolo y la documentación oficial el 2026-10-19. Este sitio ya implementa la generación de configuración y pruebas de regresión del frontend; no se ha completado la verificación de inferencia real en todos los clientes, sistemas y modelos. Vuelve a verificar después de actualizar el cliente. La conexión personalizada no implica asociación oficial ni recomendación integrada.
Más: [Clave API](/es/docs/api-keys/), [Lista de modelos](/es/docs/models/), [Registro de llamadas](/es/docs/usage-logs/), [Explicación de la dirección](/es/docs/base-url/).
---
# ChatWise Proveedor personalizado
Source: https://1zheai.com/es/docs/quickstart-chatwise/
Markdown: https://1zheai.com/es/docs/quickstart-chatwise.md
---
title: "ChatWise Proveedor personalizado"
description: "Añade un proveedor compatible con OpenAI en la configuración de ChatWise, introduciendo la clave, la dirección y los modelos."
headingIds: {"Importación de capacidades y verificación":"section-1"}
---
Crea un proveedor compatible con OpenAI personalizado en **Settings → Providers → +** de ChatWise. La consola **API Key → Herramientas → ChatWise** proporciona campos copiables.
| Campo | Valor |
| --- | --- |
| API URL / Base URL | `https://1zheai.com/v1` |
| API Key | Clave actual |
| Modelo | Selecciona tras obtener los modelos, o introduce manualmente el ID del modelo |
La interfaz de listado de modelos es `/v1/models`. Si la versión actual requiere la dirección completa de la solicitud en lugar de la Base URL, introduce `https://1zheai.com/v1/chat/completions`; sigue la descripción del campo. Desactiva los terceros proxies que no necesites antes de probar la conexión directa.
## Importación de capacidades y verificación
El `chatwise://chat` oficial y público se usa para abrir conversaciones, no para importar claves de proveedor. Este sitio no lo presenta como un botón de importación de configuración. Las capacidades de imágenes, razonamiento y herramientas deben configurarse según el soporte real de cada modelo; no actives todas por defecto.
Envía un mensaje breve y revisa los registros de este sitio. 401 indica un problema con la clave; 404 indica que el campo de dirección espera una ruta completa; si no hay modelos, introduce manualmente un ID disponible actualmente.
Oficial: [Proveedor personalizado](https://docs.chatwise.app/custom-provider), [Acuerdo de uso de la aplicación](https://docs.chatwise.app/open-from-other-apps).
El acuerdo y la documentación oficial se verificaron el 2026-10-19. Este sitio ha implementado la generación de configuración y pruebas de regresión del frontend; no se ha completado la verificación de inferencia real en todos los clientes, sistemas y modelos. Vuelve a verificar tras actualizar el cliente. La conexión personalizada no implica asociación oficial ni recomendación integrada.
Más: [API Key](/es/docs/api-keys/), [Listado de modelos](/es/docs/models/), [Registros de llamadas](/es/docs/usage-logs/), [Explicación de la dirección](/es/docs/base-url/).
---
# LibreChat Puntos finales personalizados
Source: https://1zheai.com/es/docs/quickstart-librechat/
Markdown: https://1zheai.com/es/docs/quickstart-librechat.md
---
title: "LibreChat Puntos finales personalizados"
description: "Los administradores configuran los puntos finales personalizados de LibreChat; cada usuario introduce su propia clave API."
headingIds: {"Configuración del administrador":"section-1","Verificación y solución de problemas":"section-2"}
---
LibreChat requiere que el administrador del despliegue permita los puntos finales personalizados; los usuarios normales no pueden reescribir la configuración del servidor remoto con los botones de este sitio. La consola **Clave API → Usar herramientas → LibreChat** proporciona el fragmento de configuración.
## Configuración del administrador
Fusionar en el `librechat.yaml` existente el `endpoints.custom`, sin sobrescribir otros puntos finales:
```yaml
endpoints:
custom:
- name: '1折AI'
apiKey: user_provided
baseURL: 'https://1zheai.com/v1'
models:
default: []
fetch: true
```
Aplicar la validación de configuración requerida por la versión actual y reiniciar el servicio; después, pedir a cada usuario que introduzca su propia clave en la configuración de clave API de LibreChat. La configuración compartida no contiene claves reales. Si la obtención de modelos falla, el administrador puede establecer `default` con un ID de modelo verificado y comprobar la salida a la red del servidor.
## Verificación y solución de problemas
Seleccionar el punto final y el modelo añadidos, realizar una solicitud breve y luego revisar el registro de llamadas de este sitio. Si el punto final no aparece, comprobar primero la ubicación de montaje de la configuración y si el reinicio surtió efecto; para 401, revisar la clave introducida por el usuario; para 404, verificar que la URL base sea `/v1` y no la ruta completa de la solicitud. No utilice instancias públicas de LibreChat no confiables para almacenar claves.
Oficial: [campos de punto final personalizado](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint).
protocolo y material oficial verificados el 2026-10-19. Este sitio ha implementado la generación de configuración y pruebas de regresión de la interfaz; no se ha completado la verificación de inferencia real en todos los clientes, sistemas y modelos. Vuelva a verificar después de actualizar el cliente. La conexión personalizada no implica colaboración oficial ni recomendación integrada.
Más: [clave API](/es/docs/api-keys/), [lista de modelos](/es/docs/models/), [registro de llamadas](/es/docs/usage-logs/), [explicación de direcciones](/es/docs/base-url/).
---
# Conexión de OpenClaw a la API de Claude
Source: https://1zheai.com/es/docs/quickstart-openclaw/
Markdown: https://1zheai.com/es/docs/quickstart-openclaw.md
---
title: "Conexión de OpenClaw a la API de Claude"
description: "Tutorial para configurar en OpenClaw la dirección, la clave y el modelo del retransmisor de API de Claude de 1折AI, incluyendo la selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Verificación de la conexión y solución de problemas":"section-1","Costes y otras formas de conexión":"section-2"}
---
Usa la función de proveedor personalizado de OpenClaw para conectarte a 1折AI. Primero [crea una clave API](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente](/es/docs/models/); los ID de modelo de este documento son ejemplos, ajústalos según los permisos de tu clave.
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; completa primero una breve pregunta-respuesta y la verificación de llamadas a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos](/es/docs/models/) para la lista de modelos y los precios.
Según [proveedores personalizados](https://docs.openclaw.ai/gateway/config-tools/custom-providers) y [ejemplos de configuración](https://docs.openclaw.ai/gateway/configuration-examples), combina en `~/.openclaw/openclaw.json`:
```json
{
"agents": {
"defaults": {
"model": { "primary": "onezhe/claude-sonnet-4-6" },
"models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
}
},
"models": {
"mode": "merge",
"providers": {
"onezhe": {
"baseUrl": "https://1zheai.com",
"apiKey": "${ONEZHE_API_KEY}",
"api": "anthropic-messages",
"models": [
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
]
}
}
}
}
```
Asegúrate de que el proceso que ejecuta realmente el Gateway pueda leer `ONEZHE_API_KEY`; las variables de entorno de la terminal no siempre se pasan a un servicio en segundo plano ya existente. La [documentación oficial de Synthetic](https://docs.openclaw.ai/providers/synthetic) indica que el cliente de Anthropic añade automáticamente `/v1`, por lo que aquí no se incluye `/v1` ni se rellena el `/v1/messages` completo.
Al cambiar a Chat Completions, sustitúyelos por pareja por `baseUrl: "https://1zheai.com/v1"` y `api: "openai-completions"`. Aunque el nombre contiene completions, este adaptador corresponde a `/v1/chat/completions`; no selecciones por error `openai-responses`. Si ya existe una lista blanca de modelos, conserva las demás entradas y añade el nuevo modelo. El ejemplo no inventa parámetros de coste ni de contexto; si la versión instalada actual requiere metadatos adicionales para la validación, verifica primero las capacidades reales del modelo antes de añadirlos.
## Verificación de la conexión y solución de problemas
1. Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve para confirmar que se puede obtener respuesta; después intenta una tarea pequeña y reversible, confirmando por separado las llamadas a herramientas y las conversaciones de múltiples turnos.
3. Abre el [registro de llamadas](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Que una respuesta de texto tenga éxito no significa que todas las capacidades de los Agentes sean compatibles.
4. Si aparece un 404, comprueba que la dirección y el protocolo de este documento sean compatibles; si aparece un 401, comprueba el origen de la clave y si el proceso leyó las variables de entorno; si aparece un 429, revisa la información de limitación de tasa antes de reintentar. Para más casos, consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).
Las claves solo se guardan en el entorno local o en el almacén de credenciales de la herramienta; no las envíes a repositorios de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno de la terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben comprobarse por separado.
## Costes y otras formas de conexión
Consulta los [precios en tiempo real de la API de Claude](https://1zheai.com/en/pricing/) y las [reglas de facturación](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo](/es/docs/guides/).
---
# Hermes Agent: conexión a la API de Claude
Source: https://1zheai.com/es/docs/quickstart-hermes/
Markdown: https://1zheai.com/es/docs/quickstart-hermes.md
---
title: "Hermes Agent: conexión a la API de Claude"
description: "Tutorial de configuración de Hermes Agent para conectar con la API de retransmisión de 1折AI Claude, incluyendo dirección, clave y modelo, con selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Verificación de la conexión y solución de problemas":"section-1","Costes y otras formas de conexión":"section-2"}
---
Usa la función de proveedor personalizado de Hermes Agent para conectarte a 1折AI. Primero [crea una clave API](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente](/es/docs/models/); los ID de modelo que aparecen a continuación son ejemplos, ajústalos según los permisos de tu clave.
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; realiza primero una breve verificación de preguntas y respuestas y de llamadas a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos](/es/docs/models/) para la lista de modelos y precios.
Según [Providers oficial](https://hermes-agent.nousresearch.com/docs/integrations/providers): ejecuta en la terminal `hermes model` → Custom endpoint, selecciona explícitamente el modo de API `chat_completions`, introduce en Base URL `https://1zheai.com/v1`, e introduce la clave y el modelo. No selecciones el inicio de sesión de ChatGPT/Codex, es otra forma de conexión.
Configuración de proveedor con nombre reutilizable, fusionar en `~/.hermes/config.yaml`:
```yaml
providers:
onezhe:
api: https://1zheai.com/v1
key_env: ONEZHE_API_KEY
transport: chat_completions
default_model: claude-sonnet-4-6
model:
provider: custom:onezhe
default: claude-sonnet-4-6
```
Proporcionado localmente en `~/.hermes/.env`:
```dotenv
ONEZHE_API_KEY=sk-替换为本站密钥
```
Una vez configurado, puedes cambiar de [`/model custom:onezhe:claude-sonnet-4-6` en la conversación. `/model` no puede sustituir a la creación de un nuevo proveedor desde la terminal `hermes model`. La transmisión oficial compatible es `anthropic_messages`, pero este tutorial usa Chat Completions para evitar que el protocolo se deduzca automáticamente según la URL. `OPENAI_BASE_URL` no es una configuración universal para todos los proveedores personalizados; debes usar la configuración explícita anterior.
## Verificación de la conexión y solución de problemas
1. Guarda y recarga la configuración, confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve y confirma que se puede obtener una respuesta; después intenta una pequeña tarea reversible y confirma por separado las llamadas a herramientas y la conversación de múltiples turnos.
3. Abre el [registro de llamadas](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Que una respuesta de texto tenga éxito no significa que todas las capacidades del Agente sean compatibles.
4. Si encuentras un 404, comprueba si la dirección y el protocolo de este artículo son compatibles; si encuentras un 401, comprueba el origen de la clave y si el proceso ha leído las variables de entorno; si encuentras un 429, revisa la información de limitación de tasa antes de reintentar. Para más casos consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).
Las claves solo se guardan en el entorno local o en el almacén de credenciales de la herramienta; no las envíes a repositorios de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno de la terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben comprobarse por separado.
## Costes y otras formas de conexión
Consulta los [precios en tiempo real de la API de Claude](https://1zheai.com/en/pricing/) y las [reglas de facturación](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo](/es/docs/guides/).
---
# Conectar mediante CC Switch
Source: https://1zheai.com/es/docs/quickstart-cc-switch/
Markdown: https://1zheai.com/es/docs/quickstart-cc-switch.md
---
title: "Conectar mediante CC Switch"
description: "Añade 1折AI con una configuración personalizada en CC Switch para cambiar de proveedor en Claude Code con un solo clic, sin editar manualmente settings.json."
headingIds: {"Instalación":"section-1","Añadir 1折AI a Claude Code":"section-2","Obtener la lista de modelos":"section-3","Codex":"section-4","Preguntas frecuentes":"section-5"}
---
CC Switch](https://github.com/farion1231/cc-switch) es una herramienta de escritorio que te ayuda a gestionar las configuraciones de proveedores para herramientas de línea de comandos como Claude Code y Codex. Después de añadirla una sola vez, cambiar entre tu cuenta oficial, 1折AI y otros proveedores requiere solo un clic.
## Instalación
- macOS: `brew install --cask cc-switch`
- Windows / Linux: descarga el instalador desde [GitHub Releases](https://github.com/farion1231/cc-switch/releases)
## Añadir 1折AI a Claude Code
Selecciona **Claude Code** en la barra lateral y luego haz clic en **Add Provider** (+) en la parte superior derecha de la cabecera de la página.
1折AI no está actualmente en la lista de valores preestablecidos de CC Switch, así que selecciona **Custom Configuration** en la parte superior de la lista.
Introduce `1折AI` como nombre y establece `env` en el editor de configuración con:
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
Para fijar también un modelo, añade variables como `ANTHROPIC_MODEL`; consulta la sección de mapeo de modelos de [Claude Code Integration](/es/docs/quickstart-claude-code/) para la sintaxis.
Haz clic en **Add** en el pie de página y luego activa 1折AI en la lista de proveedores. CC Switch escribe la configuración en el `~/.claude/settings.json` de Claude Code, y Claude Code usará el nuevo proveedor sin reiniciar.
Ejecuta `/status` en Claude Code; la URL base debería ser `https://1zheai.com`. Envía otro mensaje y revisa los [registros de llamadas](/es/docs/usage-logs/) de la consola para confirmar que hay un registro.
El ejemplo oficial de CC Switch usa `ANTHROPIC_API_KEY`; ambas variables funcionan. Recomendamos `ANTHROPIC_AUTH_TOKEN`; consulta [Claude Code Integration](/es/docs/quickstart-claude-code/) para conocer el motivo.
## Obtener la lista de modelos
Al editar un proveedor, el botón **Fetch Model List** junto a la entrada del modelo llama a `/v1/models` con tu clave API (API key), lista los modelos disponibles y te permite seleccionar uno para rellenarlo.
## Codex
CC Switch también puede gestionar proveedores de Codex. Para configurar la URL Base, la clave API y los modelos GPT de este sitio, consulta [Codex CLI Integration](/es/docs/quickstart-codex/).
## Preguntas frecuentes
Primero confirma en CC Switch que 1折AI está activado; luego comprueba si la terminal ha exportado `ANTHROPIC_BASE_URL` o `ANTHROPIC_AUTH_TOKEN`. Claude Code sigue settings.json, pero las variables antiguas exportadas manualmente pueden causar fácilmente errores de interpretación; se recomienda limpiarlas todas y dejar que CC Switch gestione todo.
La clave API se introdujo incorrectamente o ha sido eliminada. Copia la clave API de nuevo y ten cuidado de no incluir espacios.
---
# Configuración de CC Provider
Source: https://1zheai.com/es/docs/quickstart-cc-provider/
Markdown: https://1zheai.com/es/docs/quickstart-cc-provider.md
---
title: "Configuración de CC Provider"
description: "Administra proveedores Anthropic personalizados con la extensión CC Provider de VS Code."
headingIds: {"Pasos de configuración":"section-1","Alcance y solución de problemas":"section-2"}
---
Aquí se refiere a la extensión de VS Code **onetooken/cc-provider**, no a CC Switch. Admite endpoints Anthropic compatibles personalizados.
## Pasos de configuración
1. Instala la extensión desde el enlace del repositorio oficial y abre su panel de proveedores.
2. Crea un nuevo proveedor personalizado; en la consola **Clave API → Herramientas → CC Provider** puedes copiar los campos correspondientes.
3. En Nombre introduce `1折AI`, en Base URL introduce `https://1zheai.com`, y en API Token introduce tu propia clave.
4. Rellena el modelo principal y las ranuras de modelo necesarias según los modelos disponibles actualmente; no copies IDs de modelos de otros proveedores ni sufijos de capacidad `[1m]`.
5. Haz una copia de seguridad de la configuración existente de Claude Code antes de aplicar y revisa los campos que se modificarán. Reinicia las sesiones que necesiten leer la configuración y prueba una solicitud breve.
## Alcance y solución de problemas
Este sitio proporciona la copia de campos, pero aún no ha verificado el protocolo de importación rápida de proveedores de esta extensión. El comportamiento de este cliente al escribir la configuración de Claude Code difiere de la inclusión de proveedores integrados.
Para 401 revisa el token; para 404 revisa que la dirección raíz de Anthropic no tenga mal rellenado `/v1/messages`; si el modelo no existe, usa un modelo disponible con la clave actual. Confirma que la solicitud aparezca en el registro de llamadas de este sitio antes de usar tareas largas.
Oficial: [CC Provider](https://github.com/onetooken/cc-provider).
protocolo y material oficial verificados el 2026-10-19. Este sitio ha implementado la generación de configuración y pruebas de regresión de frontend; no se ha completado la verificación de inferencia real en todos los clientes, sistemas y modelos. Vuelve a verificar después de actualizar el cliente. La conexión personalizada no implica asociación oficial ni recomendación integrada.
Más: [Clave API](/es/docs/api-keys/), [Lista de modelos](/es/docs/models/), [Registro de llamadas](/es/docs/usage-logs/), [Explicación de direcciones](/es/docs/base-url/).
---
# Guía de desarrollo
Source: https://1zheai.com/es/docs/guides/
Markdown: https://1zheai.com/es/docs/guides.md
---
title: "Guía de desarrollo"
description: "Elige entre SDK o acceso HTTP, desde la primera solicitud hasta la salida en streaming y el almacenamiento en caché."
headingIds: {"Continúa mejorando después de la integración":"section-1","De los ejemplos a la aplicación":"section-2"}
---
Si ya tienes código, puedes empezar con el SDK correspondiente; si aún no has elegido un stack tecnológico, primero verifica la llamada con curl y luego intégrala en la aplicación.
Usa el protocolo nativo de Claude y consulta los ejemplos en Python y TypeScript.Usa el SDK de OpenAI para llamar a GPT o Claude, configurando el ID del modelo y la dirección de la interfaz.Consulta directamente las solicitudes HTTP para descartar diferencias de configuración del SDK.Confirma el endpoint, el protocolo y el alcance de aplicación.
## Continúa mejorando después de la integración
- [Salida en streaming](/es/docs/streaming/): procesa respuestas incrementales y cortes de flujo.
- [Prompt Caching](/es/docs/prompt-caching/): conoce las condiciones de uso y cómo verificar los resultados.
- [Códigos de error y solución de problemas](/es/docs/troubleshooting/): localiza problemas de configuración o del proveedor según el error específico.
- [Registro de uso y conciliación](/es/docs/usage-logs/): verifica los registros de solicitudes.
Si usas software listo para usar, puedes pasar directamente a la [integración de herramientas](/es/docs/integrations/).
## De los ejemplos a la aplicación
Python / Node.js, desde configurar las variables de entorno hasta ejecutar el programa.Distingue errores de configuración, fallos temporales y resultados inciertos.Verifica uno por uno la dirección, la clave, el modelo y el protocolo.Usa la interfaz Images y guarda los resultados generados.
---
# Integración con el SDK de Anthropic (Python / TypeScript)
Source: https://1zheai.com/es/docs/quickstart-anthropic-sdk/
Markdown: https://1zheai.com/es/docs/quickstart-anthropic-sdk.md
---
title: "Integración con el SDK de Anthropic (Python / TypeScript)"
description: "Llama a 1折AI con el SDK oficial de Anthropic: base_url es https://1zheai.com, con soporte nativo para caché, streaming, llamadas a herramientas y thinking."
headingIds: {"Instalación":"section-1","Llamada":"section-2","Salida en streaming":"section-3","Llamada con caché":"section-4","Uso de variables de entorno":"section-5","Preguntas frecuentes":"section-6","Estructura de solicitud y respuesta":"section-7"}
---
El SDK oficial de Anthropic usa el endpoint nativo `/v1/messages`, y todos los parámetros de Claude se pueden usar directamente. Lo único que hay que cambiar es `base_url` y `api_key`.
## Instalación
```bash title="Python"
pip install anthropic
```
```bash title="TypeScript / Node.js"
npm install @anthropic-ai/sdk
```
## Llamada
```python title="Python"
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://1zheai.com",
api_key=os.environ["ONEZHE_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(message.model)
print(message.content[0].text)
print(message.usage)
```
```typescript title="TypeScript"
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://1zheai.com",
apiKey: process.env.ONEZHE_API_KEY,
});
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(message.model);
console.log(message.content);
console.log(message.usage);
```
En `base_url` se indica la dirección raíz; no añadas `/v1`.
## Salida en streaming
```python title="Python"
with client.messages.stream(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "写一首四行的诗"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
```
```typescript title="TypeScript"
const stream = client.messages.stream({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "写一首四行的诗" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();
```
## Llamada con caché
Coloca el contenido largo y fijo en `system` y añade `cache_control`:
```python title="Python"
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
system=[
{
"type": "text",
"text": LONG_PROJECT_CONTEXT, # 每次都一样的长文本
"cache_control": {"type": "ephemeral"},
}
],
messages=[{"role": "user", "content": "根据上面的说明回答：..."}],
)
print(message.usage.cache_creation_input_tokens, message.usage.cache_read_input_tokens)
```
En la segunda llamada, si `cache_read_input_tokens` es mayor que 0, fue un acierto. Para más detalles, consulta [Prompt Caching](/es/docs/prompt-caching/).
## Uso de variables de entorno
El SDK oficial lee `ANTHROPIC_BASE_URL` y `ANTHROPIC_API_KEY`; también puedes no pasar parámetros al construir el cliente:
```bash
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_API_KEY="sk-你的Key"
```
Luego, al construir el cliente, no pases parámetros:
```python
client = anthropic.Anthropic() # 自动读取上面两个变量
```
Si en esta máquina Claude Code también lee estas dos variables, ambas cambiarán a 1折AI, que normalmente es justo lo que quieres.
## Preguntas frecuentes
Se escribió de más `/v1` en `base_url`. El SDK de Anthropic ensambla `/v1/messages` por sí mismo.
Comprueba la clave de API (API key); además, si en el entorno también existe `ANTHROPIC_AUTH_TOKEN` (por ejemplo, un valor antiguo configurado antes para Claude Code), el SDK también lo leerá; elimina el valor antiguo y vuelve a intentarlo.
## Estructura de solicitud y respuesta
Cuando necesites consultar system, los bloques de contenido y la razón de detención, consulta [Detalles de la interfaz Messages](/es/docs/api-messages/). Un programa completo debe leer el texto según el tipo de bloque de contenido, sin asumir que el primer bloque siempre es text.
---
# Integración con el SDK de OpenAI (Python / Node)
Source: https://1zheai.com/es/docs/quickstart-openai-sdk/
Markdown: https://1zheai.com/es/docs/quickstart-openai-sdk.md
---
title: "Integración con el SDK de OpenAI (Python / Node)"
description: "Llama a los modelos GPT y Claude de 1折AI con el SDK oficial de OpenAI: solo cambia base_url y api_key, con ejemplos de streaming y uso de variables de entorno."
headingIds: {"Instalación":"section-1","Llamada":"section-2","Salida en streaming":"section-3","Usar variables de entorno sin modificar el código":"section-4","Cuándo cambiar al SDK de Anthropic":"section-5","Preguntas frecuentes":"section-6","Responses y programa completo":"section-7"}
---
Si ya tienes código escrito con el SDK de OpenAI, cambiar a 1折AI solo requiere modificar dos parámetros: `base_url` y `api_key`. Introduce el ID del modelo GPT o Claude disponible actualmente.
## Instalación
```bash title="Python"
pip install openai
```
```bash title="Node.js"
npm install openai
```
## Llamada
```python title="Python"
import os
from openai import OpenAI
client = OpenAI(
base_url="https://1zheai.com/v1",
api_key=os.environ["ONEZHE_API_KEY"],
)
resp = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "用一句话解释什么是 prompt caching"}],
)
print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)
```
```javascript title="Node.js"
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://1zheai.com/v1",
apiKey: process.env.ONEZHE_API_KEY,
});
const resp = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "用一句话解释什么是 prompt caching" }],
});
console.log(resp.model);
console.log(resp.choices[0].message.content);
console.log(resp.usage);
```
`base_url` debe incluir `/v1`.
## Salida en streaming
```python title="Python"
stream = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "写一首四行的诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
```
```javascript title="Node.js"
const stream = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "写一首四行的诗" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
```
## Usar variables de entorno sin modificar el código
El SDK oficial de OpenAI (Python y Node) lee `OPENAI_BASE_URL` y `OPENAI_API_KEY`. Cuando el código no pasa parámetros, basta con definir estas dos variables para cambiar de proveedor:
```bash
export OPENAI_BASE_URL="https://1zheai.com/v1"
export OPENAI_API_KEY="sk-你的Key"
```
Ten en cuenta que esto afecta a todos los programas del mismo entorno que usen el SDK de OpenAI.
## Cuándo cambiar al SDK de Anthropic
La API compatible con OpenAI es adecuada para "código existente que solo quiere cambiar de modelo". Si necesitas el `cache_control` de Prompt Caching, extended thinking o el formato de llamada de herramientas de Claude, es más apropiado usar el [SDK de Anthropic](/es/docs/quickstart-anthropic-sdk/) con la API nativa.
## Preguntas frecuentes
A `base_url` le falta `/v1`. El SDK de OpenAI solo añadirá `/chat/completions` al final.
Sí. Los modelos OpenAI / GPT ya están disponibles; usa el ID de modelo de [los modelos admitidos](/es/docs/models/) que tu clave pueda invocar.
## Responses y programa completo
Si necesitas el protocolo Responses, consulta la [API de Responses](/es/docs/api-responses/). Si es tu primera vez usando Python o Node.js, puedes ejecutar directamente el [ejemplo completo](/es/docs/code-examples/); antes de entrar en producción, configura [timeouts y reintentos limitados](/es/docs/retries/).
---
# Llamadas con curl
Source: https://1zheai.com/es/docs/quickstart-curl/
Markdown: https://1zheai.com/es/docs/quickstart-curl.md
---
title: "Llamadas con curl"
description: "Sin instalar ningún SDK, usa curl para llamar a /v1/messages y /v1/chat/completions de 1折AI, consultar la lista de modelos, probar la caché y ver la salida en streaming."
headingIds: {"Nativo de Anthropic: /v1/messages":"section-1","Compatible con OpenAI: /v1/chat/completions":"section-2","Lista de modelos: /v1/models":"section-3","Salida en streaming":"section-4","Probar la caché":"section-5","Agrega -i al depurar":"section-6"}
---
curl es la forma más rápida de confirmar si "la clave de API (API key) y la dirección realmente funcionan". Cada ejemplo siguiente se puede copiar directamente; primero coloca la clave de API en una variable de entorno:
```bash
export ONEZHE_API_KEY="sk-你的Key"
```
Se recomienda a los usuarios de Windows ejecutar estos comandos en WSL o Git Bash; la sintaxis para PowerShell se encuentra en [Inicio rápido](/es/docs/quickstart/).
## Nativo de Anthropic: /v1/messages
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Compatible con OpenAI: /v1/chat/completions
```bash
curl https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Lista de modelos: /v1/models
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
## Salida en streaming
Agrega `"stream": true` y usa `-N` para desactivar el búfer de curl, para poder ver la respuesta por segmentos:
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"stream": true,
"messages": [{"role": "user", "content": "从一数到五"}]
}'
```
El formato de los eventos se describe en [Salida en streaming](/es/docs/streaming/).
## Probar la caché
Envía la misma solicitud dos veces seguidas; si el `usage.cache_read_input_tokens` de la segunda respuesta es mayor que 0, significa que hubo un acierto. El texto en `system` debe alcanzar la longitud mínima cacheable del modelo; el script completo se encuentra en [Verificar modelos y uso](/es/docs/verify-model/), y el principio se explica en [Prompt Caching](/es/docs/prompt-caching/).
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 32,
"system": [{
"type": "text",
"text": "把一段至少 512 token、每次都一样的长文本放在这里",
"cache_control": {"type": "ephemeral"}
}],
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Agrega -i al depurar
```bash
curl -i https://1zheai.com/v1/models -H "Authorization: Bearer $ONEZHE_API_KEY"
```
`-i` imprimirá el código de estado y las cabeceras de respuesta. El significado de los códigos de estado se encuentra en [Códigos de error y solución de problemas](/es/docs/troubleshooting/).
---
# Ejemplos de código ejecutables directamente
Source: https://1zheai.com/es/docs/code-examples/
Markdown: https://1zheai.com/es/docs/code-examples.md
---
title: "Ejemplos de código ejecutables directamente"
description: "Programas completos de Chat Completions en Python y Node.js, con preparación del entorno, selección de modelo, manejo de errores y comandos de ejecución."
headingIds: {"1. Preparar las variables de entorno":"section-1","2. Ejecutar según el lenguaje elegido":"section-2","Python":"section-3","Node.js":"section-4","3. Verificar los resultados":"section-5","Continuar ampliando":"section-6"}
---
Los dos programas siguientes hacen lo mismo: leer variables de entorno, realizar una solicitud de texto no en streaming y mostrar la respuesta o un error localizable. Los ejemplos desactivan los reintentos automáticos para facilitar la verificación del resultado de una sola solicitud.
## 1. Preparar las variables de entorno
Configúralas en la misma terminal desde la que ejecutarás el programa; `ONEZHE_MODEL` puede sustituirse por el ID en[los modelos disponibles con clave](/es/docs/api-models/).
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
export ONEZHE_MODEL="gpt-5.6-sol"
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$env:ONEZHE_MODEL = "gpt-5.6-sol"
```
## 2. Ejecutar según el lenguaje elegido
### Python
Instala `python -m pip install openai`, guárdalo como `chat.py` y ejecuta `python chat.py`.
```python
import os
import sys
import openai
api_key = os.environ.get("ONEZHE_API_KEY")
if not api_key:
sys.exit("请先设置 ONEZHE_API_KEY 环境变量。")
client = openai.OpenAI(
api_key=api_key,
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
try:
response = client.chat.completions.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-5.6-sol"),
messages=[{"role": "user", "content": "用一句中文解释 DNS。"}],
)
if not response.choices:
sys.exit("响应没有 choices，请检查响应协议。")
choice = response.choices[0]
print(choice.message.content or "本次响应没有普通文本。")
print("finish_reason:", choice.finish_reason)
print("response_id:", response.id)
except openai.APIStatusError as exc:
print("HTTP:", exc.status_code, "request_id:", exc.request_id, file=sys.stderr)
print("请查看控制台日志和错误码文档；不要公开密钥。", file=sys.stderr)
sys.exit(1)
except openai.APIConnectionError:
sys.exit("连接失败或超时：检查网络与代理，再核对调用日志。")
```
### Node.js
Instala `npm install openai`, guárdalo como `chat.mjs` y ejecuta `node chat.mjs`. Usar la extensión `.mjs` permite habilitar directamente ES Module.
```javascript
import OpenAI from "openai";
if (!process.env.ONEZHE_API_KEY) {
console.error("请先设置 ONEZHE_API_KEY 环境变量。");
process.exit(1);
}
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 0,
});
try {
const response = await client.chat.completions.create({
model: process.env.ONEZHE_MODEL || "gpt-5.6-sol",
messages: [{ role: "user", content: "用一句中文解释 DNS。" }],
});
const choice = response.choices[0];
if (!choice) throw new Error("响应没有 choices，请检查响应协议。");
console.log(choice.message.content || "本次响应没有普通文本。");
console.log("finish_reason:", choice.finish_reason);
console.log("response_id:", response.id);
} catch (error) {
if (error instanceof OpenAI.APIError) {
console.error("HTTP:", error.status, "request_id:", error.request_id);
console.error("请检查网络、控制台日志和错误码文档。");
} else {
console.error(error instanceof Error ? error.message : "未知错误");
}
process.exitCode = 1;
}
```
## 3. Verificar los resultados
Deberías ver una respuesta y la razón de finalización. Cuando `finish_reason` no sea `stop`, comprueba si se trata de una llamada a herramientas o de una truncación. El ID de solicitud del SDK puede estar vacío; el servidor también puede colocar el ID de seguimiento en el cuerpo del error; para depurar, complétalo a partir de la respuesta original anonimizada.
Consulta[el registro de llamadas](/es/docs/usage-logs/) para verificar las llamadas. El estado de salida del programa y la presencia o ausencia de texto normal no cubren todas las condiciones de éxito del negocio; revisa la estructura y el contenido según tu tarea.
## Continuar ampliando
- [Chat Completions](/es/docs/api-chat-completions/): historial de múltiples turnos y descripción de campos.
- [Messages](/es/docs/api-messages/): bloques de contenido nativos de Claude.
- [Responses](/es/docs/api-responses/): GPT Responses y eventos de streaming.
- [Generación de imágenes](/es/docs/api-images/): generar y guardar archivos de imagen.
- [Tiempo de espera y reintentos](/es/docs/retries/): configurar el manejo de fallos antes de entrar en producción.
---
# Salida en streaming
Source: https://1zheai.com/es/docs/streaming/
Markdown: https://1zheai.com/es/docs/streaming.md
---
title: "Salida en streaming"
description: "Salida en streaming en 1折AI: secuencia de eventos SSE nativa de Anthropic, formato de chunks compatible con OpenAI y cómo manejar la interrupción del flujo."
headingIds: {"Nativo de Anthropic":"section-1","Compatible con OpenAI":"section-2","Qué hacer si se corta el flujo":"section-3","Cómo se factura una desconexión a mitad de camino":"section-4"}
---
Para respuestas largas usa la salida en streaming (`"stream": true`), el primer carácter aparece antes y es menos probable que la red intermedia corte la petición por durar demasiado. Ambos protocolos son compatibles y el formato coincide con el oficial en cada caso.
## Nativo de Anthropic
Añade `"stream": true` a la petición; la respuesta es una secuencia de Server-Sent Events. Un flujo normal sigue este orden (procedente de [la documentación de streaming de Anthropic](https://platform.claude.com/docs/en/build-with-claude/streaming)):
| Evento | Significado |
|---|---|
| `message_start` | inicio del mensaje, con el modelo y el `usage` inicial |
| `content_block_start` | comienza un bloque de contenido (texto, thinking, tool_use) |
| `content_block_delta` | incremento de contenido; el texto va en `delta.text` |
| `content_block_stop` | fin de ese bloque de contenido |
| `message_delta` | actualización a nivel de mensaje, con `stop_reason` y el recuento final de tokens de salida |
| `message_stop` | fin de todo el mensaje |
Pueden intercalarse eventos `ping`, que se pueden ignorar; si hay un error se recibe un evento `error`.
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":128,"stream":true,
"messages":[{"role":"user","content":"从一数到五"}]}'
```
Al usar el SDK no hace falta analizar los eventos a mano; consulta los ejemplos de streaming del [SDK de Anthropic](/es/docs/quickstart-anthropic-sdk/).
## Compatible con OpenAI
Añade `"stream": true` a `/v1/chat/completions` y la respuesta son chunks en forma de `data: {...}`, con el texto en `choices[0].delta.content` y el final marcado por `data: [DONE]`. Ejemplos de SDK en [el SDK de OpenAI](/es/docs/quickstart-openai-sdk/).
El último chunk antes de `[DONE]` lleva `usage` y `choices` es un array vacío. También se devuelve aunque no envíes `stream_options.include_usage`. Flujo completo medido el 2026-10-15:
```text
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":"ok"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":""},"finish_reason":"stop"}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[],"usage":{"prompt_tokens":370,"completion_tokens":4,"total_tokens":374}}
data: [DONE]
```
Al procesar los chunks, comprueba primero si `choices` está vacío; el ejemplo de la página del SDK de OpenAI ya lo hace así.
## Qué hacer si se corta el flujo
- Primero descarta que sea el proxy: desactívalo y conecta directamente para volver a probar.
- El tiempo de lectura del cliente debe ser mayor que el tiempo de generación del modelo; con salidas largas aumenta el valor del timeout.
- Si recibes `overloaded_error` en un evento `error`, espera unos segundos y reintenta; consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).
## Cómo se factura una desconexión a mitad de camino
Una petición que se desconecta a mitad de camino no es gratis en su totalidad: se facturan los tokens de salida ya generados antes de la desconexión, y quedan registrados en el log de llamadas. Los tokens de salida facturados pueden ser algo más que los que el cliente llegó a recibir. Medido el 2026-10-15: al pedir al modelo que cuente del 1 al 600, el cliente recibió 188 líneas (unos 380 tokens de salida) cuando se desconectó en el segundo 4, y el log de llamadas registró 750 tokens de salida. Para salidas largas que no necesitas, en lugar de desconectarte a mitad de camino, mejor pon `max_tokens` pequeño desde el principio.
---
# Uso y facturación de Prompt Caching
Source: https://1zheai.com/es/docs/prompt-caching/
Markdown: https://1zheai.com/es/docs/prompt-caching.md
---
title: "Uso y facturación de Prompt Caching"
description: "Uso de Claude Prompt Caching en 1折AI: cómo activarlo, longitud mínima, cómo confirmar un acierto, cómo se facturan los aciertos y el comportamiento de almacenamiento en caché de Claude Code."
headingIds: {"Resumen primero":"section-1","Cómo activarlo":"section-2","Longitud mínima para almacenar en caché":"section-3","Confirmar un acierto":"section-4","Cómo se factura":"section-5","Caché de 1 hora":"section-6","Almacenamiento en caché de Claude Code":"section-7","¿Puede la interfaz compatible con OpenAI usar almacenamiento en caché?":"section-8","Preguntas frecuentes":"section-9"}
---
Prompt Caching permite que el prefijo largo que envías repetidamente (prompt del sistema, definiciones de herramientas, documentos largos, historial de conversación) se facture como escritura solo la primera vez, y como lectura a partir de entonces. En este sitio, las lecturas y escrituras de caché se facturan a los precios de lista oficiales, sin aplicar el descuento de entrada/salida. Los precios unitarios de caché por modelo se enumeran en [Modelos y precios](https://1zheai.com/en/pricing/).
## Resumen primero
- **Claude Code tiene el almacenamiento en caché activado de forma predeterminada**; entra en vigor en cuanto te conectas.
- Al llamar desde tu propio código, añade `cache_control` al bloque de contenido que deseas almacenar en caché, usando el nativo `/v1/messages`. La interfaz compatible con OpenAI actualmente no almacena en caché.
- Para determinar si hubo un acierto, comprueba únicamente si el `usage.cache_read_input_tokens` de la respuesta es mayor que 0.
- La caché vive 5 minutos de forma predeterminada, y cada acierto reinicia el temporizador. También puedes usar `"ttl": "1h"` para escribir una caché de 1 hora, a un precio de escritura más alto.
## Cómo activarlo
Añade `"cache_control": {"type": "ephemeral"}` a un bloque de contenido en system, tools o messages; ese bloque y todo lo anterior se almacenará en caché. Una sola solicitud puede tener como máximo 4 puntos de interrupción de caché.
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": [
{
"type": "text",
"text": "这里放一段很长、每次都一样的内容：项目说明、代码规范、参考文档……",
"cache_control": {"type": "ephemeral"}
}
],
"messages": [{"role": "user", "content": "根据上面的规范，审查这段代码：..."}]
}'
```
Si el prefijo a almacenar en caché es demasiado corto, la solicitud se procesa normalmente pero simplemente no se almacena en caché, y no se genera ningún error. La longitud mínima varía según el modelo; consulta la tabla a continuación.
## Longitud mínima para almacenar en caché
Lo siguiente proviene de [la documentación oficial de Anthropic](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) (2026-10-14):
| Recuento mínimo de tokens | Modelos |
|---|---|
| 512 | Fable 5.1, Fable 5, Opus 5.5, Opus 5, Sonnet 5.5, Haiku 5.5 |
| 1,024 | Opus 4.8, Sonnet 5, Sonnet 4.6, Sonnet 4.5 |
| 2,048 | Opus 4.7 |
| 4,096 | Opus 4.6, Opus 4.5, Haiku 4.5 |
## Confirmar un acierto
Envía la misma solicitud dos veces (con no más de 5 minutos de diferencia) y compara el `usage` de ambas. A continuación se muestran resultados reales medidos el 2026-10-15 con `claude-sonnet-5-5`, con aproximadamente 18,000 tokens de texto fijo en el sistema:
```json title="第一次：写入缓存"
{
"input_tokens": 23,
"cache_creation_input_tokens": 17920,
"cache_read_input_tokens": 0,
"cache_creation": {"ephemeral_5m_input_tokens": 17920, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
```json title="第二次：命中缓存"
{
"input_tokens": 23,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 17920,
"cache_creation": {"ephemeral_5m_input_tokens": 0, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
Si el segundo `cache_read_input_tokens` es mayor que 0, se está leyendo la caché. Los tokens de escritura y lectura de caché de cada llamada también aparecen en la columna Token del [registro de llamadas](/es/docs/usage-logs/), con las lecturas registradas como "cache↓" y las escrituras como "↑".
## Cómo se factura
| Tipo | Precio unitario oficial | Precio unitario de 1折AI |
|---|---|---|
| Escritura de caché (5 minutos) | Precio de entrada × 1.25 | Precio de lista oficial, sin descuento |
| Escritura de caché (1 hora) | Precio de entrada × 2 | Precio de lista oficial, sin descuento |
| Lectura de caché | Precio de entrada × 0.1 (0.05 para Opus 5.5 y Sonnet 5.5, 0.025 para Fable 5.1) | Precio de lista oficial, sin descuento |
El precio oficial de una escritura de caché de 5 minutos es típicamente 1.25 veces el precio oficial de entrada. En este sitio, la entrada tiene un descuento pero el almacenamiento en caché no, por lo que no puedes usar el multiplicador oficial para concluir que una sola lectura de caché se paga por sí misma; necesitas comparar el descuento del modelo, el costo de escritura y el número de lecturas repetidas. Ejemplos completos resueltos están en [Precios y facturación](/es/docs/pricing-explained/).
### Caché de 1 hora
Añade `"ttl": "1h"` a `cache_control`, y la caché se conservará durante 1 hora — adecuada para prefijos con intervalos superiores a 5 minutos que aún se usan repetidamente:
```json
"cache_control": {"type": "ephemeral", "ttl": "1h"}
```
Las escrituras se facturan a 2 veces el precio oficial de entrada, no al precio de entrada con descuento; las lecturas son las mismas que la caché de 5 minutos. Los tokens escritos aparecen en `cache_creation.ephemeral_1h_input_tokens` de la respuesta. Si elegir la caché de 1 hora debe juzgarse en función del intervalo entre las dos solicitudes, el costo de escritura y el número de lecturas repetidas.
## Almacenamiento en caché de Claude Code
Claude Code coloca automáticamente puntos de interrupción de caché en el prompt del sistema, las definiciones de herramientas y el historial de conversación; [la explicación oficial está aquí](https://code.claude.com/docs/zh-CN/prompt-caching). Para que acierte mejor:
- Trabaja continuamente dentro de una sesión; no te detengas mucho tiempo en el medio. La caché expira si no se usa durante 5 minutos.
- Las solicitudes posteriores en la misma sesión leerán la caché. Medido el 2026-10-15, para una tarea de Claude Code de dos rondas, la segunda ronda leyó 31,440 tokens de caché y escribió 115 tokens. Al iniciar una nueva sesión, la primera ronda puede necesitar reescribir todo el prefijo (medido en aproximadamente 30,000 tokens), y esa llamada será más cara que las posteriores.
- Evita cambiar `CLAUDE.md`, cambiar de servidores MCP o cambiar de modelos a mitad de sesión; todo esto cambia el prefijo.
- No establezcas `DISABLE_PROMPT_CACHING=1`; esta variable de entorno desactiva el almacenamiento en caché para todos los modelos.
## ¿Puede la interfaz compatible con OpenAI usar almacenamiento en caché?
Actualmente, no. Medido el 2026-10-15, con aproximadamente 3,100 tokens de texto fijo en el mensaje del sistema de `/v1/chat/completions`, enviados dos veces seguidas, ya se añadiera o no `cache_control` al bloque de contenido, el `usage` de ambas respuestas fue:
```json
{"prompt_tokens": 3167, "completion_tokens": 4, "total_tokens": 3171}
```
No hay `prompt_tokens_details.cached_tokens`, y las lecturas y escrituras de caché en el registro de llamadas son ambas 0; toda la solicitud se factura al precio de entrada. Para escenarios que necesitan almacenamiento en caché, usa por favor `/v1/messages` (SDK de Anthropic o Claude Code).
## Preguntas frecuentes
La caché se escribió, pero la siguiente solicitud no la leyó. Depura en orden: ¿las dos solicitudes estuvieron separadas por más de 5 minutos? ¿El contenido antes del punto de interrupción era idéntico byte a byte (las marcas de tiempo y los IDs aleatorios en el sistema lo hacen diferente cada vez)? ¿Se cambió el modelo? ¿El prefijo alcanzó la longitud mínima anterior?
Los tokens de lectura y escritura de caché de cada llamada están en el registro de llamadas, así que puedes calcularlo tú mismo: lecturas de caché ÷ (entrada + escrituras de caché + lecturas de caché).
---
# Timeouts, rate limits and retries
Source: https://1zheai.com/es/docs/retries/
Markdown: https://1zheai.com/es/docs/retries.md
---
title: "Timeouts, rate limits and retries"
description: "Configure SDK timeouts and limited retries, distinguish retryable errors from configuration errors, and avoid duplicate submissions."
headingIds: {"Which cases should be retried":"section-1","Use the SDK’s built-in retries first":"section-2","When implementing retries yourself":"section-3","Record enough debugging information":"section-4"}
---
Fix configuration errors first, then handle transient failures. Limit retry count, concurrency, and total wait time together to avoid sending the same failed request many times in a short period.
## Which cases should be retried
| Case | Recommendation |
| --- | --- |
| 400 / 401 / 403 / 404 | Fix the request, permissions, or model first; do not automatically repeat the original request |
| 429 | Check the response message; when `Retry-After` is present, follow the wait time and reduce concurrency |
| 500 / 502 / 503 / 504 / 529 | Limited retries are allowed; if failures persist, stop and report the request ID |
| Connection failure | Check DNS, proxy, and network; retry within the time allowed by the task |
| Timeout or stream interruption after the request was sent | The result may be uncertain; check logs first; do not assume the upstream has not processed it |
The retry scope of client libraries may not exactly match the table above. Whichever layer you use for retries, explicitly set the policy at that layer.
## Use the SDK’s built-in retries first
Python and Node.js use different timeout units: Python uses seconds, Node.js uses milliseconds. The example below sets a 120-second timeout and up to 2 automatic retries; when debugging an initial integration, you can change it to 0.
```python title="Python"
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=2,
)
```
```javascript title="Node.js"
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 2,
});
```
The timeout setting is not an upper bound on the total time for the entire business task: retries and waits increase the total time. If an outer layer will re-execute the task, set a separate total deadline and cancellation mechanism.
## When implementing retries yourself
Disable the SDK's automatic retries to avoid stacking. Use progressively increasing wait intervals with random jitter; explicitly limit the number of attempts, maximum wait, and concurrency queue. When parsing `Retry-After`, note that it may be either seconds or an HTTP date.
If partial streaming results have already been shown to the user, do not automatically replay from the beginning and append after the old text. Keep the "incomplete" state and let the user decide whether to regenerate or continue.
For image generation, tool execution, and other tasks that may produce external results, pay special attention to duplicate submissions. Do not assume that setting an arbitrary request ID will make the server automatically deduplicate.
## Record enough debugging information
Record the time, endpoint, model, status code, duration, attempt number, and the request ID returned by the server. Avoid logging authentication headers and full private prompts. Use this information to cross-reference the [call logs ](/es/docs/usage-logs/).
For SDK settings, see the [OpenAI Python SDK ](https://github.com/openai/openai-python#retries) and [Node SDK ](https://github.com/openai/openai-node#retries). For specific errors, see [error codes and troubleshooting ](/es/docs/troubleshooting/).
---
# Referencia de la API
Source: https://1zheai.com/es/docs/api-reference/
Markdown: https://1zheai.com/es/docs/api-reference.md
---
title: "Referencia de la API"
description: "Encuentra interfaces documentadas, ejemplos de solicitudes y diferencias de protocolo, y aclara el alcance de compatibilidad."
headingIds: {"Índice de interfaces":"section-1","Alcance de compatibilidad":"section-2","Respuestas y fallos":"section-3"}
---
Aquí se recopilan las descripciones de las interfaces existentes en este sitio y los ejemplos de solicitudes. Este sitio ya ofrece modelos Claude y OpenAI / GPT. Selecciona el protocolo correspondiente según el modelo y la herramienta; los modelos concretos dependen de la lista disponible en tu clave.
## Índice de interfaces
| Interfaz | Propósito | Descripción y ejemplos |
| --- | --- | --- |
| `POST /v1/messages` | Diálogo nativo de Anthropic | [Solicitud y respuesta](/es/docs/api-messages/), [SDK de Anthropic](/es/docs/quickstart-anthropic-sdk/), [curl](/es/docs/quickstart-curl/) |
| `POST /v1/chat/completions` | Diálogo compatible con OpenAI | [Solicitud y respuesta](/es/docs/api-chat-completions/), [SDK de OpenAI](/es/docs/quickstart-openai-sdk/), [curl](/es/docs/quickstart-curl/) |
| `POST /v1/responses` | OpenAI Responses | [Solicitud y respuesta](/es/docs/api-responses/), [Codex CLI](/es/docs/quickstart-codex/) |
| `GET /v1/models` | Consultar los modelos disponibles para la clave | [Formato de lista y consulta](/es/docs/api-models/), [Selección de modelos](/es/docs/models/) |
| `POST /v1/messages/count_tokens` | Conteo de tokens de entrada | [Descripción de la interfaz](/es/docs/base-url/) |
| `POST /v1/images/generations` | Generación de imágenes a partir de texto | [Integración de generación de imágenes](/es/docs/api-images/) |
## Alcance de compatibilidad
Para las capacidades nativas de Claude, consulta primero el tutorial de integración de Anthropic. Antes de cambiar de protocolo, verifica en el tutorial correspondiente que la capacidad necesaria esté descrita; no infieras solo porque la solicitud se haya completado con éxito que las llamadas a herramientas, la caché o las tareas largas sean compatibles.
Codex usa `/v1/responses`; consulta [Integración de Codex CLI](/es/docs/quickstart-codex/). Los modelos disponibles actualmente dependen de la [descripción de modelos](/es/docs/models/) y de la lista que devuelva realmente tu clave.
## Respuestas y fallos
formato de eventos y manejo de interrupciones de flujo en ambos protocolos. localizar problemas según el código de estado y el mensaje de error.
Las descripciones detalladas de las interfaces ofrecen solicitudes mínimas, campos comunes, lectura de resultados y límites de compatibilidad; los parámetros completos siguen requiriendo la documentación del protocolo del modelo elegido. Este sitio aún no ofrece una especificación OpenAPI completa descargable.
Los Embeddings, Batch, alojamiento de archivos y modelos propietarios de terceros no confirmados en el catálogo público no están dentro del alcance prometido en esta página. Si necesitas estas capacidades, confírmalo primero con soporte.
---
# URL base, interfaces y autenticación
Source: https://1zheai.com/es/docs/base-url/
Markdown: https://1zheai.com/es/docs/base-url.md
---
title: "URL base, interfaces y autenticación"
description: "URL base de 1折AI, interfaces disponibles, cómo escribir las cabeceras de solicitud y cuándo añadir /v1 en distintas herramientas."
headingIds: {"Interfaces disponibles":"section-1","Si hay que añadir /v1":"section-2","Cabeceras de autenticación":"section-3","Comprobar si la clave API está disponible":"section-4","Límites de velocidad":"section-5","Red":"section-6"}
---
Todas las solicitudes se envían al mismo dominio, con dos conjuntos de rutas según el protocolo.
```text
https://1zheai.com
```
## Interfaces disponibles
| Interfaz | Protocolo | Uso |
|---|---|---|
| `POST /v1/messages` | Nativo de Anthropic | Conversación. Claude Code, Anthropic SDK y Cline (modo Anthropic) usan esta |
| `POST /v1/chat/completions` | Compatible con OpenAI | Conversación. OpenAI SDK, Cursor y Cherry Studio (modo OpenAI) usan esta |
| `GET /v1/models` | Compatible con OpenAI | Lista los modelos que puede usar tu clave API (API key) |
| `POST /v1/messages/count_tokens` | Nativo de Anthropic | Calcula el número de tokens de una entrada; no genera conversación ni cobra |
El cuerpo de la solicitud de `count_tokens` es igual que el de `/v1/messages` (`model`, `messages`, y puede incluir `system` y `tools`); la respuesta solo tiene un campo:
```json
{"input_tokens":19}
```
`count_tokens` solo cuenta lo que envías. Cuando se llama realmente mediante un SDK, curl o una herramienta de terceros, cada solicitud incluye además un mensaje de sistema que se factura según los tokens de entrada (Claude Code no lo incluye); consulta[el facturación del mensaje de sistema](/es/docs/pricing-explained/#section-3).
Capacidades propias de Claude como Prompt Caching, extended thinking o las llamadas a herramientas funcionan de forma más fiable con el `/v1/messages` nativo. La interfaz compatible con OpenAI es adecuada para escenarios en los que ya tienes código de OpenAI y solo quieres cambiar de modelo.
## Si hay que añadir /v1
Diferentes herramientas interpretan la URL base de forma distinta; este es el error más común al conectar:
| Herramienta / SDK | Qué rellenar | Motivo |
|---|---|---|
| Claude Code (`ANTHROPIC_BASE_URL`) | `https://1zheai.com` | La herramienta añade por sí misma `/v1/messages` |
| Anthropic SDK (`base_url`) | `https://1zheai.com` | Igual que arriba |
| OpenAI SDK (`base_url`) | `https://1zheai.com/v1` | El SDK solo añade `/chat/completions` |
| Cursor (Override OpenAI Base URL) | `https://1zheai.com/v1` | Igual que OpenAI SDK |
| Cherry Studio | `https://1zheai.com` | Añade automáticamente `/v1/...` |
| Cline (OpenAI Compatible) | `https://1zheai.com/v1` | Igual que OpenAI SDK |
Regla: en la familia Anthropic se rellena la dirección raíz; en la familia OpenAI se rellena hasta `/v1`. El síntoma típico de rellenarlo mal es un 404.
## Cabeceras de autenticación
La clave API se coloca en la cabecera de la solicitud; se pueden usar ambas formas:
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="Bearer（两种协议都支持）"
Authorization: Bearer sk-你的Key
content-type: application/json
```
- Al llamar a `/v1/messages`, incluye `anthropic-version` según el protocolo oficial; el valor actual es `2023-06-01`. En pruebas funciona sin él, pero el SDK y las herramientas oficiales lo incluyen, así que inclúyelo también cuando escribas las solicitudes a mano.
- El `ANTHROPIC_AUTH_TOKEN` de Claude Code envía `Authorization: Bearer`, y el `ANTHROPIC_API_KEY` envía `x-api-key`; aceptamos ambos.
- Cuando necesites funciones beta, incluye la cabecera `anthropic-beta` según la documentación oficial. Incluir un valor no reconocido no provoca error, así que si una función beta está activa o no, se determina por el efecto real en la respuesta.
## Comprobar si la clave API está disponible
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-你的Key"
```
Si devuelve la lista de modelos, la clave API y la dirección son correctas. Si devuelve 401, el problema es la clave API; la respuesta tiene esta forma (probado el 2026-10-15):
```json
{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}
```
Al solicitar `/v1/models` con las cabeceras `x-api-key` y `anthropic-version`, se devuelve la lista de modelos en formato Anthropic (`data[].id`, `display_name`, `has_more`); el descubrimiento automático de modelos de Claude Code lee este formato.
Para otros casos, consulta[códigos de error y solución de problemas](/es/docs/troubleshooting/).
## Límites de velocidad
Actualmente no se aplican límites de velocidad a las claves API. Si recibes un 429, normalmente es por alta carga del proveedor upstream; reintenta más tarde y añade retroceso exponencial en tareas por lotes. Consulta[códigos de error y solución de problemas](/es/docs/troubleshooting/).
## Red
Si hay timeout de conexión o errores de TLS, comprueba primero la red que usa el terminal: si tienes un proxy global activo, desactívalo y conecta directamente para probar de nuevo; si la red corporativa tiene una lista blanca de salidas, es necesario permitir `1zheai.com`.
---
# Consultar modelos disponibles API
Source: https://1zheai.com/es/docs/api-models/
Markdown: https://1zheai.com/es/docs/api-models.md
---
title: "Consultar modelos disponibles API"
description: "Los dos formatos de respuesta de GET /v1/models, la lectura de los ID de modelo, y la diferencia entre la visibilidad de un modelo y su disponibilidad real para invocarlo."
headingIds: {"Formato OpenAI":"section-1","Formato Anthropic":"section-2","Cómo usar los resultados de la consulta":"section-3","Lista vacía o faltan modelos":"section-4"}
---
Primero consulta los modelos, luego escribe la solicitud. `GET https://1zheai.com/v1/models` devuelve los modelos visibles bajo la clave actual, el grupo y las restricciones de modelo, sin necesidad de enviar una solicitud de inferencia.
## Formato OpenAI
```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
A continuación se muestra un esquema simplificado de la estructura; la lista depende de lo que se devuelva realmente:
```json
{
"object": "list",
"data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```
Cuando está instalado `jq`, puedes añadir `| jq -r '.data[].id'` después de la solicitud, mostrando un ID de modelo por línea. No confundas el `model_name` de la interfaz pública de precios con el `id` de aquí.
## Formato Anthropic
Al usar las siguientes dos cabeceras de solicitud, la misma ruta devuelve datos al estilo de Anthropic:
```bash
curl --fail-with-body https://1zheai.com/v1/models \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01"
```
Presta atención a `data[].id`, `data[].display_name` y `has_more`. Después de cambiar el método de autenticación, no sigas analizando la respuesta con la estructura del otro formato.
## Cómo usar los resultados de la consulta
1. Copia el ID completo desde `data[].id`, conservando mayúsculas, minúsculas, guiones y sufijos de fecha.
2. Verifica el tipo de interfaz de ese modelo en el [catálogo de modelos de la consola](https://1zheai.com/model-catalog?lng=es).
3. Valida con una solicitud de texto mínimo y luego añade gradualmente imágenes, herramientas u otros parámetros.
La lista de modelos no es una comprobación de salud en tiempo real ni incluye todas las restricciones de parámetros. Un modelo puede estar visible pero, si temporalmente no hay un upstream disponible, la solicitud aún puede fallar; el monitoreo de disponibilidad HTTP del sitio oficial tampoco significa que todos los modelos puedan inferir con éxito.
## Lista vacía o faltan modelos
Verifica las restricciones de modelo y el grupo de la clave; los modelos mostrados en la página pública de precios no necesariamente están abiertos a cada clave. Para 401, primero revisa el estado de la clave; para 403, revisa las condiciones de acceso; consulta los pasos detallados en [códigos de error y solución de problemas](/es/docs/troubleshooting/).
Para las series de modelos y recomendaciones de selección, consulta [modelos compatibles](/es/docs/models/).
---
# Interfaz de diálogo Chat Completions
Source: https://1zheai.com/es/docs/api-chat-completions/
Markdown: https://1zheai.com/es/docs/api-chat-completions.md
---
title: "Interfaz de diálogo Chat Completions"
description: "Solicitud mínima, campos comunes, lectura de respuestas y forma de escribir diálogos de múltiples turnos para POST /v1/chat/completions."
headingIds: {"Solicitud mínima":"section-1","Campos comunes":"section-2","Cómo leer la respuesta":"section-3","Diálogo de múltiples turnos":"section-4","Streaming y siguientes pasos":"section-5"}
---
Usa un cliente compatible con OpenAI, o si ya tienes código `chat.completions.create`, comienza con esta interfaz. La dirección completa es `https://1zheai.com/v1/chat/completions`; en la Base URL del SDK solo se rellena hasta `/v1`.
## Solicitud mínima
Primero configura `ONEZHE_API_KEY` en la terminal con la clave de este sitio. Los modelos siguientes deben existir en [tu lista de modelos disponibles](/es/docs/api-models/).
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "请用一句中文解释 DNS 的作用。"}]
}'
```
`--fail-with-body` hace que los errores HTTP devuelvan un código de salida distinto de cero, conservando a la vez el cuerpo del error; requiere curl 7.76 o una versión más reciente. En versiones anteriores, puedes usar primero `-i` para ver el código de estado.
## Campos comunes
| Campo | Tipo | Forma de uso |
| --- | --- | --- |
| `model` | string | Obligatorio, copia el ID del modelo de este sitio, sin añadir prefijos de proveedor de otras plataformas |
| `messages` | array | Obligatorio, envía en orden la pregunta de esta ronda y los mensajes del historial que deban conservarse |
| `messages[].role` | string | Para conversaciones normales usa `user` / `assistant`; el soporte del rol de instrucciones del sistema depende del modelo |
| `messages[].content` | string o array de bloques de contenido | Para texto plano usa primero una cadena; la entrada de imágenes requiere que el modelo admita el bloque de contenido correspondiente |
| `stream` | boolean | Cuando se establece en `true` se lee SSE, sin tratar toda la respuesta como un único JSON |
| `temperature` | number | Opcional, algunos modelos de razonamiento no admiten modificarlo; omítelo primero y verifica elemento por elemento |
| `tools` / `tool_choice` | array / string u object | Opcional, tanto el modelo como el origen deben admitirlo; la ejecución real de las herramientas la realiza tu programa |
Los parámetros de límite de salida varían según el modelo. No intercambies mecánicamente el `max_tokens` de Claude, el `max_output_tokens` de Responses y los parámetros de Chat Completions; consulta los requisitos del modelo elegido y, ante un 400, revisa primero el cuerpo del error.
## Cómo leer la respuesta
El resultado de texto normal se encuentra en `choices[0].message.content`. El motivo de finalización está en `choices[0].finish_reason`; cuando se devuelven llamadas a herramientas, el texto puede estar vacío y es necesario leer `message.tool_calls`. El `id`, `model` y `usage` de la respuesta pueden usarse para verificar esta llamada.
A continuación solo se muestra la estructura que requiere atención; los campos y números omitidos no representan el resultado real de una solicitud:
```json
{
"id": "example-completion",
"object": "chat.completion",
"model": "gpt-5.6-sol",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "DNS 将域名解析为网络地址。"},
"finish_reason": "stop"
}]
}
```
## Diálogo de múltiples turnos
La interfaz no recuerda automáticamente la ronda anterior solo porque reutilices la misma clave. Envía junto el historial que deba conservarse:
```json
{
"model": "gpt-5.6-sol",
"messages": [
{"role": "user", "content": "我正在学习 DNS。"},
{"role": "assistant", "content": "我们可以从域名解析开始。"},
{"role": "user", "content": "它和 HTTP 有什么区别？"}
]
}
```
Cuanto más largo es el historial, mayor es la solicitud. La aplicación debe recortar o resumir según el límite de contexto y conservar los pares completos de llamadas a herramientas y resultados.
## Streaming y siguientes pasos
Al añadir `"stream": true`, los incrementos de texto provienen de `choices[].delta.content`. Algunos eventos no tienen texto o `choices` está vacío, por lo que hay que comprobarlo al leer; consulta [salida en streaming](/es/docs/streaming/).
Ejecuta directamente [ejemplo completo en Python / Node.js](/es/docs/code-examples/), o cambia a [Responses](/es/docs/api-responses/); los parámetros nativos de Claude están en [Messages](/es/docs/api-messages/).
---
# Interfaz nativa de conversación Messages
Source: https://1zheai.com/es/docs/api-messages/
Markdown: https://1zheai.com/es/docs/api-messages.md
---
title: "Interfaz nativa de conversación Messages"
description: "Cabeceras de solicitud de Claude Messages, diferencias entre system y messages, bloques de contenido y motivos de finalización."
headingIds: {"Solicitud mínima":"section-1","Estructura de la solicitud":"section-2","Lectura de bloques de contenido":"section-3","Múltiples turnos y streaming":"section-4"}
---
Claude Code, el SDK de Anthropic y las aplicaciones que deseen conservar los bloques de contenido nativos de Claude utilizan `POST https://1zheai.com/v1/messages`. Introduzca `https://1zheai.com` en la URL base del SDK.
## Solicitud mínima
Primero configure la variable de entorno de la clave de este sitio `ONEZHE_API_KEY` y luego ejecute:
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": "请用简短的中文回答。",
"messages": [{"role": "user", "content": "什么是域名解析？"}]
}'
```
## Estructura de la solicitud
| Campo | Tipo | Uso |
| --- | --- | --- |
| `model` | string | Obligatorio, selecciona el modelo Claude disponible para la clave |
| `max_tokens` | integer | Obligatorio, límite de salida; configúrelo en combinación con las limitaciones del modelo seleccionado |
| `messages` | array | Obligatorio, envía los mensajes `user` y `assistant` en orden cronológico |
| `system` | string o array de bloques de contenido | Opcional, las instrucciones del sistema se colocan en el nivel superior, no se usa el mensaje `role: system` |
| `stream` | boolean | Opcional, lee los incrementos de los bloques de contenido en streaming |
| `tools` | array | Opcional, declara los nombres de las herramientas, su propósito y el esquema de entrada |
`thinking`, el control de caché y los parámetros beta dependen del modelo específico y del soporte del proveedor. Primero verifique el texto normal y luego añada lo que necesite; no trate todos los modelos como si tuvieran el mismo conjunto de parámetros.
## Lectura de bloques de contenido
El `content` devuelto es un array y puede contener simultáneamente texto, solicitudes de herramientas u otros bloques de contenido. No lea `content[0].text` de forma incondicional. Por ejemplo, con el SDK de Python de Anthropic:
```python
for block in message.content:
if block.type == "text":
print(block.text)
```
Aquí `message` procede de `client.messages.create(...)` en [el tutorial del SDK de Anthropic](/es/docs/quickstart-anthropic-sdk/).
| `stop_reason` | Cómo lo procesa la aplicación |
| --- | --- |
| `end_turn` | La respuesta de esta ronda ha terminado |
| `max_tokens` | La salida se ha truncado por el límite y no puede considerarse una respuesta completa |
| `tool_use` | Compruebe las solicitudes de herramientas, ejecute las herramientas permitidas y devuelva los resultados |
| Otros valores | Conserve la respuesta y procesela según el protocolo del modelo seleccionado; no asuma que siempre es una finalización de texto |
En el bucle de llamadas a herramientas, primero añada el bloque de contenido completo del asistente al historial y luego devuélvalo mediante `tool_result` en el contenido del usuario; `tool_use_id` debe corresponder a la solicitud original. No convierta directamente una solicitud de herramienta en un texto normal.
## Múltiples turnos y streaming
Cada vez que envíe, conserve el historial necesario; la interfaz no almacena la conversación por la aplicación. El streaming indica el fin del mensaje con `message_stop`; recibir una parte del texto no significa que la solicitud haya finalizado. Consulte [salida en streaming](/es/docs/streaming/).
Para los detalles del protocolo, consulte [instrucciones de uso de Anthropic Messages](https://platform.claude.com/docs/en/build-with-claude/working-with-messages). La disponibilidad de los parámetros extendidos de este sitio depende del catálogo de modelos y de la respuesta real.
---
# Interfaz de Responses
Source: https://1zheai.com/es/docs/api-responses/
Markdown: https://1zheai.com/es/docs/api-responses.md
---
title: "Interfaz de Responses"
description: "Conecta 1折AI mediante la interfaz de Responses de OpenAI; conoce el input, el output, los eventos en streaming y los límites de compatibilidad."
headingIds: {"Solicitud mínima":"section-1","Diferencias con Chat Completions":"section-2","SDK de Python":"section-3","Lectura en streaming":"section-4","Alcance de compatibilidad":"section-5"}
---
Codex CLI utiliza el protocolo Responses. Al escribir tu propia aplicación, también puedes solicitar modelos GPT compatibles con esta interfaz a través de `POST https://1zheai.com/v1/responses`. En el Base URL del SDK de OpenAI, introduce `https://1zheai.com/v1`.
## Solicitud mínima
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/responses \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"input": "用三句话解释 API 网关。",
"store": false
}'
```
Antes de ejecutar, define `ONEZHE_API_KEY` y verifica que el modelo figure en [tu lista de modelos disponibles](/es/docs/api-models/). `store: false` es una opción de almacenamiento del protocolo; no significa que todos los niveles de servicio carezcan de registros o retención de datos; no infieras compromisos de privacidad a partir de ello.
## Diferencias con Chat Completions
| Contenido | Chat Completions | Responses |
| --- | --- | --- |
| Entrada | `messages` | `input`, que puede ser una cadena o elementos de entrada estructurados |
| Resultado de texto | `choices[].message.content` | Bloques de contenido de mensaje en `output` |
| Atributos auxiliares de texto del SDK | Extraer la opción por tu cuenta | `response.output_text` |
| Texto en streaming | `choices[].delta.content` | Eventos `response.output_text.delta` |
| Determinación de finalización | `finish_reason` y fin del stream | Comprobar el estado de la respuesta y el evento de terminación |
`output_text` es un atributo de conveniencia proporcionado por el SDK; no asumas que este campo exista en el nivel superior del JSON HTTP original. Al llamar directamente a HTTP, recorre `output`, selecciona `type: message` y luego lee el `text` de `type: output_text` en su `content`.
## SDK de Python
Después de instalar `python -m pip install openai`:
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
response = client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="用三句话解释 API 网关。",
store=False,
)
print(response.output_text)
print("status:", response.status)
```
Aquí se desactivan los reintentos automáticos para facilitar la localización de una única solicitud durante la primera integración. Antes de publicar, configura la política según [tiempos de espera y reintentos](/es/docs/retries/).
## Lectura en streaming
Úsalo después de inicializar `client` arriba:
```python
with client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="用三句话解释 API 网关。",
store=False,
stream=True,
) as stream:
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
print("\n完成")
elif event.type in {"response.failed", "response.incomplete", "error"}:
raise RuntimeError(f"响应未完成：{event.type}")
```
Si se desconecta sin recibir el evento de finalización, marca el resultado como incompleto; no juzgues el éxito únicamente por el texto ya emitido.
## Alcance de compatibilidad
Esta página cubre la creación de respuestas y la lectura de texto. No infieras de ello que todas las capacidades —tareas en segundo plano, recuperación de respuestas históricas, `previous_response_id`, herramientas alojadas, almacenamiento de archivos, etc.— estén disponibles. Cuando necesites continuar una sesión, valida primero con una entrada de historial explícita; cuando necesites una herramienta concreta, valida caso por caso según el modelo y el cliente.
Para configurar herramientas preexistentes, consulta [Codex CLI](/es/docs/quickstart-codex/). Para el uso del SDK, consulta [OpenAI Python SDK](https://github.com/openai/openai-python).
---
# Integración de generación de imágenes
Source: https://1zheai.com/es/docs/api-images/
Markdown: https://1zheai.com/es/docs/api-images.md
---
title: "Integración de generación de imágenes"
description: "Genera imágenes con la API de imágenes de OpenAI, guarda los resultados en Base64 y resuelve problemas de permisos de modelos y tiempos de espera."
headingIds: {"API y configuración":"section-1","Generar y guardar una imagen":"section-2","Confirma el soporte del modelo antes de añadir parámetros":"section-3","Resolución de problemas":"section-4"}
---
El catálogo público de modelos de este sitio enumera actualmente `gpt-image-1.5` y `chatgpt-image-latest` (verificado el 2026-10-16). Antes de usarlos, consulta primero [los modelos disponibles para tu clave ](/es/docs/api-models/) y luego confirma la API de imágenes y sus parámetros en el [catálogo de modelos de la consola ](https://1zheai.com/model-catalog?lng=es).
Esta página ofrece ejemplos de integración siguiendo el protocolo de imágenes de OpenAI; no se realizó ninguna generación de imágenes de pago durante esta actualización de la documentación, por lo que los ejemplos siguientes no deben considerarse probados en todas las combinaciones de modelo, tamaño y calidad.
## API y configuración
- Endpoint completo: `POST https://1zheai.com/v1/images/generations`
- URL base del SDK de OpenAI: `https://1zheai.com/v1`
- Usa la variable de entorno `ONEZHE_API_KEY` en este sitio.
- Instala el SDK de Python: `python -m pip install openai`.
## Generar y guardar una imagen
Guárdala como `generate-image.py` y luego ejecuta `python generate-image.py` en la terminal:
```python
import base64
import os
from pathlib import Path
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=300.0,
max_retries=0,
)
result = client.images.generate(
model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
)
if not result.data:
raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
item = result.data[0]
if item.b64_json:
target = Path("generated-image.png")
target.write_bytes(base64.b64decode(item.b64_json, validate=True))
print(f"图片已保存到 {target.resolve()}")
elif item.url:
print("返回的是图片地址，请及时下载：", item.url)
else:
raise RuntimeError("响应没有 b64_json 或 url。")
```
El ejemplo usa el formato de salida predeterminado. Si especificas JPEG / WebP u otro formato, cambia la extensión del archivo en consecuencia al guardarlo. No escribas la cadena Base64 directamente en un archivo de texto y la renombres a PNG.
## Confirma el soporte del modelo antes de añadir parámetros
Verifica primero con una solicitud que contenga solo `model` y `prompt`. Parámetros como el tamaño, la calidad, el fondo transparente y el formato de salida no se admiten de forma universal en todos los modelos de imágenes; no copies directamente nombres de modelos o parámetros propietarios de otros proveedores.
Cuando se devuelva `data[].b64_json`, realiza la decodificación Base64; cuando se devuelva `data[].url`, descárgalo de inmediato y no trates la URL temporal como almacenamiento permanente. La aplicación debe organizar su propio almacenamiento de resultados.
## Resolución de problemas
| Situación | Método de solución |
| --- | --- |
| 400 parámetro no admitido | Elimina los parámetros opcionales como el tamaño personalizado y la calidad, y luego verifica uno por uno |
| 403 / 404 | Comprueba el ID del modelo de imagen, los permisos de la clave y la ruta completa de la API |
| Espera prolongada | Establece un tiempo de espera razonable para la generación y muestra un estado en curso para evitar envíos repetidos por clics continuos |
| Sin imagen después del tiempo de espera | Comprueba primero los registros de llamada; no recibir un resultado no significa que el origen no haya procesado la solicitud |
| Quiero editar una imagen existente | La edición de imágenes es una API y un método de entrada diferentes; el ejemplo de texto a imagen de esta página no puede sustituirla directamente |
Para la referencia de parámetros del protocolo, consulta [Referencia de generación de imágenes de OpenAI ](https://developers.openai.com/api/reference/resources/images/methods/generate). Las tarifas se basan en el catálogo de modelos en tiempo real de este sitio; para la estrategia de reintentos, consulta [Tiempos de espera y reintentos ](/es/docs/retries/).
---
# Cuenta y soporte
Source: https://1zheai.com/es/docs/support/
Markdown: https://1zheai.com/es/docs/support.md
---
title: "Cuenta y soporte"
description: "Gestiona cargos y registros de llamadas, localiza problemas de integración y proporciona la información de diagnóstico necesaria."
headingIds: {"Pedidos de la tienda":"section-1","Cargos y cuenta":"section-2","Problemas al realizar llamadas":"section-3","Consulta por cuenta propia":"section-4"}
---
## Pedidos de la tienda
[Guía de compra](/es/docs/store-guide/) · [Resolución de problemas de pedidos](/es/docs/store-orders/) · [Reglas de transacciones y servicio posventa](/es/docs/store-rules/)
Para problemas con cuentas listas para usar, recargas y tarjetas de regalo, primero verifica el estado en[Mis pedidos](https://1zheai.com/store-orders?lng=es); al contactar con soporte, proporciona el número de pedido y la información de error anonimizada, sin enviar contraseñas, códigos de verificación ni datos completos de sesión.
## Cargos y cuenta
conoce la composición de los cargos y las notas de cálculo.consulta las reglas de pago y servicio posventa.localiza cada llamada y verifica los cargos.consulta las instrucciones de creación, almacenamiento y rotación.
## Problemas al realizar llamadas
Primero consulta[Códigos de error y diagnóstico](/es/docs/troubleshooting/), luego verifica[Direcciones y protocolos](/es/docs/base-url/) y[Límites de herramientas](/es/docs/integrations/). Para comprobar el modelo y el uso, consulta[Verificar modelo y uso](/es/docs/verify-model/).
Si aún necesitas ayuda, proporciona a través de los canales de soporte publicados en la consola o en el sitio web: hora y zona horaria del incidente, herramienta y versión, ID del modelo, código de estado HTTP, ID de solicitud (si lo hay), información de error anonimizada, y si es posible reproducirlo con una solicitud mínima.
No envíes claves API completas, cabeceras de autenticación ni conversaciones completas que contengan contenido privado.
## Consulta por cuenta propia
- [Preguntas frecuentes de integración](/es/docs/faq/): direcciones, modelos, lectura de respuestas y significado del monitoreo.
- [Tiempos de espera y reintentos](/es/docs/retries/): configuración del tiempo de espera del cliente y manejo de fallos.
- [Guía de migración](/es/docs/migration/): cambio desde el proveedor original paso a paso.
---
# Precios y facturación
Source: https://1zheai.com/es/docs/pricing-explained/
Markdown: https://1zheai.com/es/docs/pricing-explained.md
---
title: "Precios y facturación"
description: "Las entradas y salidas de Claude se facturan con el descuento del modelo, y la lectura y escritura de caché al precio oficial sin descuento; verifica el costo de las llamadas con los ejemplos de facturación por categoría."
headingIds: {"Cuánto se cobra por cada llamada":"section-1","Ejemplos":"section-2","Facturación del prompt del sistema":"section-3","Saldo y moneda":"section-4","Cómo verificar los descuentos y los costos":"section-5","Preguntas frecuentes":"section-6"}
---
**Las entradas y salidas de Claude se facturan con el descuento de ese modelo, y la lectura y escritura de caché al precio oficial sin descuento.** Los precios unitarios y descuentos de cada modelo están en [Modelos y precios](https://1zheai.com/en/pricing/). Para GPT, MiMo y los modelos de generación de imágenes consulta sus respectivas unidades de facturación y precios; los ejemplos de tokens de esta página corresponden a Claude.
## Cuánto se cobra por cada llamada
Cada llamada se factura por separado según las cuatro categorías de tokens en el `usage` de la respuesta:
```text
费用 = ( 输入 token × 输入单价
+ 缓存写入 token × 缓存写单价
+ 缓存读取 token × 缓存读单价
+ 输出 token × 输出单价 ) ÷ 1,000,000
输入单价、输出单价 = 对应官方单价 × 该模型折扣
缓存读取单价、缓存写入单价 = 对应官方原价
```
Las cuatro categorías de tokens corresponden a estos campos de la respuesta:
| Concepto de facturación | Campo `usage` (nativo de Anthropic) | Precio unitario oficial relativo al precio de entrada |
|---|---|---|
| Entrada | `input_tokens` | 1× |
| Escritura de caché | `cache_creation_input_tokens` | 1.25× (caché de 5 minutos), 2× (caché de 1 hora, `"ttl": "1h"`) |
| Lectura de caché | `cache_read_input_tokens` | 0.1× (Opus 5.5 y Sonnet 5.5 son 0.05×, Fable 5.1 es 0.025×) |
| Salida | `output_tokens` | Según el modelo, ver la página de precios |
Los multiplicadores oficiales de la caché provienen de la documentación de [Anthropic Prompt Caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching). En este sitio la caché se factura al precio oficial correspondiente, sin aplicar el descuento de entrada y salida.
Los tokens de escritura de la caché de 1 hora se registran por separado en `cache_creation.ephemeral_1h_input_tokens` y se facturan a 2 veces el precio oficial de entrada, sin aplicar el descuento de entrada y salida. Los precios unitarios de escritura de caché listados en la página de precios corresponden a la caché de 5 minutos.
## Ejemplos
Los precios unitarios siguientes son enteros tomados al azar para la demostración; no corresponden a ningún modelo en particular. Los precios unitarios reales están en la página de precios.
Supongamos que un modelo tiene los siguientes precios unitarios oficiales (por millón de tokens): entrada $3, salida $15, escritura de caché $3.75, lectura de caché $0.30. El `usage` de una solicitud de Claude Code es:
```json
{
"input_tokens": 2000,
"cache_creation_input_tokens": 1500,
"cache_read_input_tokens": 30000,
"output_tokens": 800
}
```
Al precio oficial:
| Concepto | Tokens | Precio unitario oficial | Costo oficial |
|---|---|---|---|
| Entrada | 2,000 | $3 | $0.006 |
| Escritura de caché | 1,500 | $3.75 | $0.005625 |
| Lectura de caché | 30,000 | $0.30 | $0.009 |
| Salida | 800 | $15 | $0.012 |
| Total | | | $0.032625 |
Supongamos que la entrada y la salida de este modelo de ejemplo tienen un 20% del precio oficial (solo para el ejemplo; no representa los precios actuales de los modelos). Entonces:
```text
输入费用 = $0.006 × 0.2 = $0.0012
输出费用 = $0.012 × 0.2 = $0.0024
缓存费用 = $0.005625 + $0.009 = $0.014625
合计 = $0.018225
```
No se puede multiplicar directamente el costo oficial total por el descuento de entrada y salida, porque la parte de la caché no tiene descuento.
Si la caché no coincide en la misma solicitud, esos 30,000 tokens se calcularán al precio de entrada con descuento de ese modelo. Para determinar si se ahorra dinero hay que comparar el descuento del modelo, el costo de escritura de la caché y el número de lecturas repetidas; no basta comparar los precios oficiales. La configuración y el método de verificación están en [Prompt Caching](/es/docs/prompt-caching/).
## Facturación del prompt del sistema
La API de Claude proviene de una cuenta de suscripción oficial. Las llamadas a través de Claude Code no incluyen contenido adicional. Las demás clientes (SDK, curl y herramientas de terceros) incluyen en cada solicitud un prompt del sistema que se factura como tokens de entrada: aproximadamente 350 tokens en Sonnet 4.6 y aproximadamente 500 tokens en la serie 5.x. Esta parte se suma a tu propio contenido y se incluye en el `usage` del `input_tokens` de la respuesta.
Medición real del 2026-10-15 enviando con curl «Reply with just: ok»:
| Modelo | Conteo de `count_tokens` | `input_tokens` real | Prompt del sistema incluido (aprox.) |
|---|---|---|---|
| Sonnet 4.6 | 19 | 370 | 350 tokens |
| Serie 5.x | 18–19 | 510–530 | aproximadamente 500 tokens |
- `count_tokens` solo cuenta lo que tú envías, sin incluir este prompt del sistema. Al estimar el costo con SDK, curl o herramientas de terceros, suma los números de la tabla anterior; con Claude Code no es necesario.
- Los tokens de entrada registrados en el registro de llamadas ya incluyen esta parte; al recalcular con la fórmula anterior el resultado coincide con el cargo del registro.
- Cuanto más corta es la solicitud, mayor es la proporción de esta parte; en solicitudes con contexto largo es muy pequeña.
## Saldo y moneda
- Los cargos se calculan con el algoritmo en dólares anterior y se descuentan de tu saldo de cuenta. El saldo se mide en dólares.
- El capital de recarga se acredita en dólares; la tarifa de procesamiento de pago se lista aparte y no se reembolsa. Las formas de pago disponibles y los límites de monto se rigen por la página de pedido de la billetera.
## Cómo verificar los descuentos y los costos
Primero consulta el descuento de entrada y salida de ese modelo y luego calcula por separado la entrada, la salida, la lectura de caché y la escritura de caché. Cada cargo se puede recalcular en el [registro de llamadas](/es/docs/usage-logs/) con el precio unitario correspondiente.
## Preguntas frecuentes
La causa más común es que la caché no coincide: pasó demasiado tiempo entre dos solicitudes (la caché dura 5 minutos por defecto), cambió la primera parte del contexto o se cambió de modelo. Abre el registro de llamadas y compara los tokens de lectura de caché de ambas entradas para verlo.
No. La lectura y la escritura de caché se facturan al precio oficial sin descuento; la entrada y la salida se facturan con el descuento de cada modelo.
Las llamadas a través de Claude Code no incluyen contenido adicional. Las demás clientes (SDK, curl y herramientas de terceros) incluyen en cada solicitud un prompt del sistema que se factura como tokens de entrada: aproximadamente 350 tokens en Sonnet 4.6 y aproximadamente 500 tokens en la serie 5.x. Los datos medidos están en [Facturación del prompt del sistema](#section-3).
Busca esta entrada en el registro de llamadas, toma los conteos de los cuatro tipos de tokens y los precios unitarios de la página de precios, e introdúcelos en la fórmula anterior; el resultado debe coincidir con el cargo del registro. Si no coincide, envíanos la hora y el modelo de este registro.
---
# Registros de uso y conciliación
Source: https://1zheai.com/es/docs/usage-logs/
Markdown: https://1zheai.com/es/docs/usage-logs.md
---
title: "Registros de uso y conciliación"
description: "Consulta en el registro de llamadas de la consola de 1折AI el modelo, los cuatro tipos de tokens y el cargo de cada llamada, y recalcula una cuenta según la fórmula."
headingIds: {"Dónde consultarlo":"section-1","Qué contiene cada registro":"section-2","Conciliar una cuenta":"section-3","Usar el registro para ver el efecto de la caché":"section-4","No coincide con tus propias estadísticas":"section-5"}
---
Cada llamada deja un detalle en el registro de llamadas. Esta página explica cómo consultarlo y cómo conciliar.
## Dónde consultarlo
En la consola](https://1zheai.com/console?lng=es), menú lateral → «Registro de llamadas» (dirección `https://1zheai.com/usage-logs`), el título de la página es «Registro general».
En la parte superior puedes filtrar por rango de tiempo; al pulsar «Expandir» también puedes filtrar por nombre del modelo, nombre de la clave API («Nombre del token»), ID de solicitud y tipo de log. Después de filtrar, pulsa «Buscar»; «Exportar» descarga los resultados filtrados actuales para facilitar la conciliación en una hoja de cálculo.
## Qué contiene cada registro
| Columna | Contenido |
|---|---|
| Hora | Momento en que ocurrió la solicitud |
| Token | Nombre de la clave API usada en esta llamada |
| Modelo | ID del modelo realmente invocado |
| Flujo | «Flujo» o «No flujo», además de la velocidad de salida (t/s) |
| Token | La primera línea es «entrada / salida»; si hay caché, hay una línea más debajo: tras «Caché↓» están los tokens de lectura de caché, y tras «↑» los tokens de escritura de caché |
| Costo | Importe en dólares cargado por esta llamada |
| Duración | Duración total; las solicitudes en flujo también muestran el tiempo hasta la primera palabra |
| Detalles | Precio unitario y otros detalles de esta llamada |
Las solicitudes rechazadas por la pasarela (clave API inválida, saldo insuficiente, modelo mal escrito, etc.) no generan cargo. Las solicitudes con error devuelto por el proveedor upstream tienen un costo de 0. Si una solicitud en flujo se interrumpe a mitad, no es gratis en su totalidad, consulta[Salida en flujo](/es/docs/streaming/).
## Conciliar una cuenta
Busca por hora y modelo la entrada que quieres verificar y anota los cuatro valores de la columna Token: entrada, salida, lectura de caché (Caché↓) y escritura de caché (↑).
En la[página de precios](https://1zheai.com/en/pricing/)localiza los precios unitarios de entrada, salida, lectura de caché y escritura de caché de ese modelo (entrada y salida ya calculados con el descuento del modelo; la caché al precio oficial original).
```text
扣费 = ( 输入 × 输入单价
+ 缓存写入 × 缓存写单价
+ 缓存读取 × 缓存读单价
+ 输出 × 输出单价 ) ÷ 1,000,000
```
El resultado debería coincidir con el cargo del registro. El redondeo puede producir diferencias en el último decimal.
Si no coincide, envíanos la hora, el modelo y una captura de este registro.
## Usar el registro para ver el efecto de la caché
En herramientas como Claude Code, la mayor parte de la entrada debería caer en la columna «lectura de caché». Si varias entradas seguidas tienen mucha «escritura de caché» y muy poca «lectura de caché», significa que la caché no se está reutilizando; las causas y las soluciones están en [Prompt Caching](/es/docs/prompt-caching/).
Una tasa de acierto aproximada: lectura de caché ÷ (entrada + escritura de caché + lectura de caché).
## No coincide con tus propias estadísticas
- Claude Code usa modelos de nivel Haiku para algunas pequeñas tareas en segundo plano, por lo que en el registro aparecerán modelos que no seleccionaste activamente. Consulta el mapeo de modelos en [Integración con Claude Code](/es/docs/quickstart-claude-code/).
- Los tokens de entrada del registro superan en cientos lo que enviaste: cuando usas SDK, curl u otras herramientas de terceros, cada solicitud incluye un fragmento de prompt de sistema que se factura como entrada (Claude Code no lo incluye), consulta[Facturación del prompt de sistema](/es/docs/pricing-explained/#section-3).
- Una «conversación» dentro de una herramienta puede corresponder a muchas llamadas a la API (una ronda por cada llamada a herramienta); el registro se guarda por llamada a la API.
---
# Recargas, reembolsos y facturas
Source: https://1zheai.com/es/docs/billing/
Markdown: https://1zheai.com/es/docs/billing.md
---
title: "Recargas, reembolsos y facturas"
description: "Cómo recargar en 1zheai, monto mínimo, métodos de pago admitidos, reglas de reembolso de saldo no utilizado en 7 días, y qué tipo de factura se puede emitir según cada método de pago."
headingIds: {"Recarga":"section-1","Reembolso de saldo API":"section-2","Facturas":"section-3","Preguntas frecuentes":"section-4"}
---
Esta página explica el saldo de la cuenta API: primero recargas, y al hacer llamadas se descuenta según el uso. Los productos de cuenta de IA se compran según las especificaciones del producto; para el servicio posterior consulta [el centro de cuentas ](https://1zheai.com/en/store/), al que no se aplican las reglas de reembolso de saldo API de esta página.
Las reglas de reembolso de saldo de este documento se aplican a las recargas de la API de modelos. Para pedidos de cuentas listas para usar, recargas por terceros y tarjetas de regalo, consulta [las reglas de transacciones y servicio posterior de la tienda ](/es/docs/store-rules/), a las que no se aplica directamente la regla de 7 días de la API.
## Recarga
| Elemento | Descripción |
|---|---|
| Límite de monto | Según la página de pedido de la billetera |
| Métodos de pago | WeChat Pay, Alipay, Stripe (tarjeta bancaria), USDT |
| Acceso | [Consola ](https://1zheai.com/console?lng=es) menú lateral «Billetera» → «Añadir fondos» |
| Cómo se cobra | Claude entrada y salida con descuento según el modelo, cachere al precio oficial; otros modelos según la tarifa correspondiente, ver [Precios y facturación ](/es/docs/pricing-explained/) |
El principal de la recarga se acredita en dólares; la tarifa de procesamiento de pago se cobra aparte y no se reembolsa.
## Reembolso de saldo API
**Dentro de los 7 días posteriores a la recarga, puedes solicitar el reembolso del principal no utilizado por el mismo medio de pago. La parte ya consumida y la tarifa de procesamiento de pago no se reembolsan.**
Consulta en el registro de llamadas el consumo posterior a esta recarga; el principal no utilizado reembolsable según la billetera es la referencia; la tarifa de procesamiento de pago no se incluye en el principal reembolsable.
Envía un correo a support@1zheai.com indicando la cuenta, la hora de recarga y el método de pago.
Si es tu primer uso, puedes recargar primero el monto permitido por la billetera, luego ejecutar la verificación según [Verificar modelo y uso ](/es/docs/verify-model/), y usarlo unos días en tus tareas reales. Dentro de los 7 días puedes solicitar el reembolso del principal no utilizado por el mismo medio de pago; la tarifa de procesamiento de pago no se reembolsa.
## Facturas
| Método de pago | Qué se puede emitir |
|---|---|
| WeChat Pay / Alipay | Se puede emitir factura, con un recargo del 6% del monto pagado |
| Stripe (tarjeta bancaria) | Factura de Stripe (en inglés) |
| USDT | No se emite factura |
Para emitir facturas, compras corporativas y transferencias a cuenta de empresa, envía un correo a support@1zheai.com para contactar.
## Preguntas frecuentes
El límite de monto según la página de pedido de la billetera. Antes de pagar, verifica el principal de recarga, la tarifa de procesamiento de pago y el monto acreditable.
Cuando el saldo se agota, la solicitud devuelve HTTP 403, y en la respuesta está `Insufficient user quota` (en `/v1/messages`, `error.type` es `billing_error`; en `/v1/chat/completions` es `insufficient_quota`). Las solicitudes rechazadas no se cobran; tras acreditar la recarga puedes seguir usándolo.
Las llamadas a través de Claude Code no llevan contenido adicional. Otras clientes (SDK, curl y herramientas de terceros) añaden en cada solicitud un mensaje del sistema, facturado según tokens de entrada: Sonnet 4.6 aproximadamente 350 tokens, serie 5.x aproximadamente 500 tokens. La explicación y los datos medidos están en [Facturación del mensaje del sistema ](/es/docs/pricing-explained/#section-3).
La regla de reembolso de saldo API es el principal no utilizado dentro de los 7 días posteriores a la recarga; la parte ya consumida y la tarifa de procesamiento de pago no se reembolsan. Para casos fuera de los 7 días, contáctanos por separado para explicar.
---
# Verificar el modelo y el uso
Source: https://1zheai.com/es/docs/verify-model/
Markdown: https://1zheai.com/es/docs/verify-model.md
---
title: "Verificar el modelo y el uso"
description: "Verifica el modelo, el uso de tokens y el costo de cada llamada con el registro de llamadas y cinco comprobaciones."
headingIds: {"Registro de llamadas":"section-1","Cinco comprobaciones":"section-2","Completar las cuatro primeras con un script":"section-3","Bloques thinking":"section-4","Al detectar inconsistencias":"section-5","Preguntas frecuentes":"section-6"}
---
## Registro de llamadas
Cada llamada se registra en el [registro de llamadas](/es/docs/usage-logs/) de la consola, que enumera el modelo, el uso de tokens de entrada, salida, lectura de caché y escritura de caché, así como el costo.
## Cinco comprobaciones
Las siguientes comprobaciones se basan en el formato público de la interfaz de Anthropic y sirven para detectar diferencias en los campos y el formato de la respuesta.
| Comprobación | Resultado esperado | Qué vigilar |
|---|---|---|
| 1. Campo `model` devuelto | Coincide con el ID del modelo solicitado | Devuelve otro nombre de modelo, o el campo no está presente |
| 2. Lectura de caché | La misma solicitud que cumple las condiciones de caché se envía dos veces dentro de la vigencia de la caché; el `cache_read_input_tokens` de la segunda es mayor que 0 | Siempre es 0, o `usage` no contiene campos de caché |
| 3. ID de llamada a herramientas | El `id` del bloque `tool_use` comienza con `toolu_` | Otro formato, o el modelo no llama a las herramientas según lo requerido |
| 4. Orden de eventos de streaming | Aparecen en orden `message_start`, `content_block_start`, `content_block_delta`, `message_delta` y `message_stop` | Solo bloques `data:` en formato OpenAI, o eventos ausentes o en orden incorrecto |
| 5. Contraste con una tarea real | Comparar los resultados de una tarea fija con la API oficial u otra fuente confiable | Resultados claramente peores, rechazos anómalos o cortes frecuentes |
Estas comprobaciones solo pueden detectar diferencias en los campos y el formato; no pueden confirmar por sí solas el modelo realmente utilizado. El campo `model` puede ser alterado y el formato también puede ser imitado.
## Completar las cuatro primeras con un script
Se necesitan `bash`, `curl` y `jq`. El script realiza cinco llamadas pequeñas, una de las cuales escribe en caché aproximadamente 18 mil tokens, facturados al precio normal.
```bash title="verify.sh"
#!/usr/bin/env bash
# 用法：ONEZHE_API_KEY=sk-你的API密钥 bash verify.sh [模型ID]
set -euo pipefail
BASE="https://1zheai.com"
MODEL="${1:-claude-sonnet-5-5}"
H=(-H "x-api-key: $ONEZHE_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json")
echo "== 1. model 字段"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:16,messages:[{role:"user",content:"ping"}]}')" \
| jq 'if .error then .error else {id, model, usage} end'
echo "== 2. 缓存：同一请求发两次，看第二次的 cache_read_input_tokens"
LONG=$(printf '这是一段用来测试缓存的固定文本，内容不重要，长度够就行。%.0s' {1..600})
BODY=$(jq -n --arg m "$MODEL" --arg t "$LONG" '{model:$m,max_tokens:16,
system:[{type:"text",text:$t,cache_control:{type:"ephemeral"}}],
messages:[{role:"user",content:"ping"}]}')
for i in 1 2; do
curl -s "$BASE/v1/messages" "${H[@]}" -d "$BODY" | jq -c 'if .error then .error else .usage end'
done
echo "== 3. 工具调用 ID"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:256,
tools:[{name:"get_weather",description:"查询城市天气",
input_schema:{type:"object",properties:{city:{type:"string"}},required:["city"]}}],
tool_choice:{type:"auto"},
messages:[{role:"user",content:"北京今天天气怎么样"}]}')" \
| jq -r 'if .error then .error.message else (.content[]? | select(.type=="tool_use") | .id) end'
echo "== 4. 流式事件序列"
curl -sN "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:32,stream:true,messages:[{role:"user",content:"数到三"}]}')" \
| grep '^event:' | uniq
```
El punto 3 usa `tool_choice: auto`. Los modelos 5.x como Sonnet 5.5 no admiten la especificación forzada de herramientas (`{"type":"tool"}` o `{"type":"any"}`) y devuelven un error 400 `does not support forced tool_choice`.
La siguiente salida fue medida el 2026-10-15 con `claude-sonnet-5-5` (el punto 1 solo conserva los campos clave):
```text
== 1. model 字段
{
"id": "msg_011Cg3Esh8zeEdLeXAPVALKe",
"model": "claude-sonnet-5-5",
"usage": {
"input_tokens": 518,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 12,
...
}
}
== 2. 缓存：同一请求发两次，看第二次的 cache_read_input_tokens
{"input_tokens":23,"cache_creation_input_tokens":17920,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":17920,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
{"input_tokens":23,"cache_creation_input_tokens":0,"cache_read_input_tokens":17920,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
== 3. 工具调用 ID
toolu_01UPsdyKX8M9fJTTkDoSKHXA
== 4. 流式事件序列
event: message_start
event: content_block_start
event: ping
event: content_block_delta
event: content_block_stop
event: message_delta
event: message_stop
```
Si el evento `ping` aparece o en qué posición no es fijo y no afecta la evaluación.
## Bloques thinking
Con thinking activado, el bloque `thinking` devuelto incluye el campo `signature`, que también puede usarse como comprobación de formato. La forma de escribirlo en los modelos 5.x difiere de la de los 4.x; medido el 2026-10-15:
| Modelo | Parámetro `thinking` | Resultado |
|---|---|---|
| `claude-sonnet-4-6` | `{"type":"enabled","budget_tokens":1024}` | Devuelve el bloque `thinking`, con texto de pensamiento y `signature` |
| `claude-sonnet-5` | `{"type":"enabled","budget_tokens":1024}` o `{"type":"adaptive"}` | Ambas funcionan |
| `claude-sonnet-5-5` | `{"type":"adaptive"}` | Funciona; al pasar `enabled` devuelve 400 indicando que solo se admite adaptive |
El bloque `thinking` de los modelos 5.x solo contiene `signature` por defecto, y el texto de pensamiento es una cadena vacía. Para ver el resumen del pensamiento, añade `"display": "summarized"`:
```json
"thinking": {"type": "adaptive", "display": "summarized"}
```
Al usar sitios web de detección de terceros, se recomienda crear una clave API dedicada y eliminarla después de la prueba.
## Al detectar inconsistencias
Envía un correo a support@1zheai.com con la hora de la solicitud, el ID del modelo, el contenido completo de la respuesta (elimina la clave API) y el punto de comprobación correspondiente. El request id en la respuesta o en el mensaje de error puede ayudar a localizar esta llamada.
## Preguntas frecuentes
No es fiable. La autodescripción del modelo está influenciada por el prompt del sistema y, con ciertos prompts, puede responder incorrectamente su propia versión. Verificar los campos devueltos y el formato de los eventos es más útil.
Claude Code usa el modelo Haiku para algunas tareas en segundo plano, y en el registro de llamadas aparecen los registros correspondientes. Puedes especificar el modelo para este tipo de tareas con la variable de entorno `ANTHROPIC_DEFAULT_HAIKU_MODEL`; consulta [integración con Claude Code](/es/docs/quickstart-claude-code/). Si esto ocurre sin usar Claude Code, envía la hora de la solicitud a support@1zheai.com.
---
# Códigos de error y solución de problemas
Source: https://1zheai.com/es/docs/troubleshooting/
Markdown: https://1zheai.com/es/docs/troubleshooting.md
---
title: "Códigos de error y solución de problemas"
description: "Causas y soluciones cuando al llamar a 1折AI encuentras 401, 404, 429, 529, 5xx, tiempos de espera y errores de Claude Code."
headingIds: {"Orden de verificación":"section-1","Referencia rápida de códigos de error":"section-2","Respuestas reales probadas":"section-3","Verificación por síntoma":"section-4","401 / Invalid token":"section-5","404 / Invalid URL":"section-6","403 / error code: 1010":"section-7","429 demasiadas solicitudes":"section-8","529 / overloaded_error":"section-9","Tiempos de espera, desconexión a mitad del streaming":"section-10","Claude Code: entra directamente en la interfaz de inicio de sesión":"section-11","Claude Code: Extra inputs are not permitted / context_management devuelve 400":"section-12","Saldo suficiente pero las llamadas fallan":"section-13","Reintentos limitados y plantilla de reporte":"section-14","Aún no resuelto":"section-15"}
---
Primero revisa la siguiente lista en orden; la mayoría de los problemas se encuentran en los tres primeros pasos.
## Orden de verificación
1. **Dirección**: las herramientas de Anthropic usan `https://1zheai.com`, las de OpenAI usan `https://1zheai.com/v1`. Ver [Base URL y autenticación](/es/docs/base-url/).
2. **Clave API (API key)**: ¿está completa (sin espacios ni saltos de línea extra), ¿ha sido eliminada, ¿se introdujo en el campo correcto?
3. **Saldo**: ¿el saldo en la consola es suficiente?
4. **ID del modelo**: ¿coincide exactamente con el de [modelos admitidos](/es/docs/models/)?
5. **Red**: desactiva el proxy y vuelve a probar en conexión directa.
6. **Si aún no funciona**: envíanos una reproducción mínima con curl (ver abajo), junto con la respuesta y el tiempo.
```bash title="最小复现"
curl -i https://1zheai.com/v1/messages \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
```
`-i` imprimirá el código de estado junto con las cabeceras de respuesta, lo cual es muy útil al depurar.
## Referencia rápida de códigos de error
| Código de estado | Causa común | Qué hacer |
|---|---|---|
| 400 | Problema en el cuerpo de la solicitud: nombre de parámetro incorrecto, tipo de campo incorrecto, `max_tokens` supera el límite del modelo, incluye campos beta que el upstream no reconoce | Revisa el campo señalado en `message`; para Claude Code consulta más abajo "Extra inputs are not permitted" |
| 401 | Clave API inválida, eliminada, deshabilitada, expirada, cuota propia agotada, o no incluida / colocada en la cabecera incorrecta | Todas las respuestas son `Invalid token`, revisa punto por punto; en Anthropic nativo usa `x-api-key` o `Authorization: Bearer` |
| 403 | Saldo de la cuenta insuficiente (`billing_error` / `insufficient_quota`); esta clave API no tiene habilitado ese modelo; la IP de la solicitud no está en la lista blanca de esta clave API (ambos son `permission_error`) | Recarga saldo, o edita las restricciones de modelo y la lista blanca de IP de esta clave API en la página "Clave API" |
| 404 | Ruta incorrecta, o el modelo no existe / no está disponible actualmente | `Invalid URL` verifica la dirección; `not_found_error` / `model_not_found` verifica el ID del modelo y la lista de disponibilidad |
| 413 | Cuerpo de la solicitud demasiado grande | Reduce el contenido enviado de una vez; divide los archivos grandes en partes |
| 429 | Limitación temporal de tasa por el upstream. Actualmente no aplicamos límites de velocidad a las claves API | Reintenta más tarde; en tareas por lotes añade retroceso exponencial |
| 503 | El modelo existe pero no hay un servicio upstream saludable disponible temporalmente, o fallo temporal del servicio | Reintenta más tarde; si el fallo persiste, contacta soporte indicando el ID de solicitud |
| 500 / 502 | Fallo temporal de la puerta de enlace o del upstream | Reintenta más tarde; si persiste, envía un correo a support@1zheai.com |
| 504 | Tiempo de espera agotado en la solicitud | Usa streaming para salidas largas; aumenta el tiempo de espera del cliente |
| 529 | Sobrecarga del upstream Anthropic (`overloaded_error`) | Espera unos segundos y reintenta, o cambia temporalmente a otro modelo |
El significado completo de los tipos de error oficiales de Anthropic (`invalid_request_error`, `authentication_error`, `rate_limit_error`, `overloaded_error`, etc.) está en la [documentación oficial Errors](https://platform.claude.com/docs/en/api/errors).
Los errores devueltos por el upstream se devuelven con el código de estado y `message` tal cual, y `message` añade al final el request id de esta solicitud. Al usar `/v1/messages`, la capa externa es la estructura oficial `{"type":"error","error":{...}}`, y `error.type` se rellena con el tipo oficial según el código de estado; al usar `/v1/chat/completions` es la estructura `{"error":{...}}` de OpenAI.
## Respuestas reales probadas
A continuación se muestran respuestas reales probadas el 2026-10-15 contra `/v1/messages`. Al usar `/v1/chat/completions` el contenido es el mismo, la capa externa no tiene `"type":"error"`, y `error` tiene un campo `code` adicional.
```json title="401 API 密钥无效、禁用、过期或额度用完"
{"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"}
```
```json title="403 账户余额不足"
{"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"}
```
```json title="403 API 密钥没开通该模型"
{"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"}
```
```json title="403 IP 不在白名单"
{"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"}
```
```json title="400 上游参数错误"
{"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"}
```
```json title="404 路径不存在"
{"error":{"message":"Invalid URL (POST /v1/nonexistent)","type":"invalid_request_error","param":"","code":""}}
```
La explicación del 404 cuando el modelo no existe o no está disponible está en [modelos admitidos](/es/docs/models/). El request id de la respuesta corresponde a tu solicitud; inclúyelo al reportar un problema.
## Verificación por síntoma
### 401 / Invalid token
- La clave API se copió con espacios o saltos de línea extra; vuelve a copiarla.
- La clave API fue eliminada o deshabilitada en la consola, o expiró, o su cuota propia se agotó. En todos estos casos la respuesta es la misma frase `Invalid token`.
- En Claude Code se han configurado a la vez `ANTHROPIC_API_KEY` y `ANTHROPIC_AUTH_TOKEN`, y uno de ellos es un valor antiguo: deja solo uno, se recomienda `ANTHROPIC_AUTH_TOKEN`.
- El `env` de `settings.json` sobrescribe la variable homónima exportada en la terminal; si cambiar la variable de la terminal no surte efecto, revisa `~/.claude/settings.json`.
### 404 / Invalid URL
Primero mira el tipo de error: `not_found_error` o `model_not_found` requieren revisar [el ID del modelo y la lista de disponibilidad](/es/docs/models/). `Invalid URL` requiere revisar `/v1`: OpenAI SDK, Cursor, Cline (OpenAI Compatible) deben rellenar hasta `https://1zheai.com/v1`; Claude Code y el SDK de Anthropic solo rellenan `https://1zheai.com`, si rellenas `/v1` se convertirá en `/v1/v1/messages`.
### 403 / error code: 1010
Si la respuesta solo contiene la línea `error code: 1010` y no hay JSON, significa que la solicitud fue bloqueada antes de llegar a la puerta de enlace. Se sabe que ocurre al enviar solicitudes directamente con la biblioteca estándar de Python `urllib` (su User-Agent por defecto es `Python-urllib/3.x`). Añade tu propio `User-Agent` en las cabeceras de la solicitud, o cambia al SDK oficial, `requests`, `httpx`.
### 429 demasiadas solicitudes
Actualmente no aplicamos límites de velocidad a las claves API. Recibir un 429 suele deberse a alta carga en el upstream; reintenta más tarde. Para tareas por lotes se recomienda retroceso exponencial: espera un tiempo tras cada fallo antes de reintentar, duplicando la espera en cada intento, y controla la concurrencia con tu propia cola.
### 529 / overloaded_error
El upstream Anthropic está sobrecargado temporalmente; no tiene relación con tu clave API ni con tu saldo. Espera unos segundos y reintenta; si tienes prisa, cambia temporalmente a otro modelo de la misma serie.
### Tiempos de espera, desconexión a mitad del streaming
- Para respuestas largas usa streaming (`"stream": true`) siempre que sea posible; es menos propenso a ser cortado por dispositivos de red intermedios.
- Claude Code puede usar `API_TIMEOUT_MS` para aumentar el tiempo de espera; el valor por defecto es 600000 (10 minutos).
- Si tienes un proxy activado, desactívalo y prueba una vez; muchas desconexiones de streaming provienen de nodos de proxy.
### Claude Code: entra directamente en la interfaz de inicio de sesión
Significa que Claude Code no leyó tu clave API. Ejecuta `/status` en Claude Code y revisa las líneas de base URL y origen de credenciales; si están vacías, vuelve a [integración con Claude Code](/es/docs/quickstart-claude-code/) para revisar las variables de entorno o `settings.json`.
### Claude Code: Extra inputs are not permitted / context_management devuelve 400
Claude Code incluye en la solicitud algunos campos beta experimentales; un upstream estricto que no los reconoce devolverá 400. Configura la siguiente variable de entorno para desactivarlos (procedente de la documentación oficial de LLM gateway de Claude Code):
```bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
```
### Saldo suficiente pero las llamadas fallan
- Si solo falla un modelo, puede que ese modelo esté temporalmente no disponible, que el ID esté mal escrito, o que esta clave API tenga restricciones de modelo (403 `This token has no access to model …`).
- Si todos fallan con 401, comprueba si esta clave API tiene un límite de cuota ya agotado, o si expiró. Puedes verlo en las columnas "Cuota ($)" y "Expira" de la página "Clave API".
- Para otros casos consulta la tabla de códigos de error anterior.
## Reintentos limitados y plantilla de reporte
No uses bucles infinitos para ocultar errores de configuración. Para tiempos de espera del SDK, número de reintentos automáticos y manejo de retroceso consulta [tiempos de espera y reintentos](/es/docs/retries/).
Al contactar con soporte puedes copiar la siguiente plantilla, eliminar las claves, cabeceras de autenticación y contenido privado antes de enviarla:
```text
发生时间与时区：
客户端及版本：
请求方法与完整路径：
模型 ID：
HTTP 状态码：
request id（如有）：
脱敏后的错误正文：
最小请求能否复现：
是否使用代理 / 是否仅某个模型失败：
```
## Aún no resuelto
Envía un correo a support@1zheheai.com, adjuntando la hora, el ID del modelo, la herramienta y versión que usas, y la salida completa de `curl -i` (elimina la clave API).
---
# IA y automatización
Source: https://1zheai.com/es/docs/ai/
Markdown: https://1zheai.com/es/docs/ai.md
---
title: "IA y automatización"
description: "Permita que un asistente de IA lea la documentación bajo demanda, conociendo el estado de las entradas de lectura para máquinas y del MCP de documentación."
headingIds: {"Entradas de lectura para máquinas disponibles":"section-1","Tareas de integración para la IA":"section-2","Estado del MCP de documentación":"section-3"}
---
Puede pedir a un asistente de IA que primero lea la documentación de este sitio y luego ayude a configurar herramientas o escribir código de llamadas. La lectura normal de la documentación y las llamadas a la API del modelo son dos cosas distintas: leer la documentación pública no requiere proporcionar una clave de API.
## Entradas de lectura para máquinas disponibles
| Entrada | Uso |
| --- | --- |
| [llms.txt](/es/docs/llms.txt) | Descubrir la documentación por sección y elegir las páginas que necesita leer |
| [Lista de documentos](/es/docs/docs-manifest.json) | Obtener el título de la página, la sección a la que pertenece, y las direcciones web y de Markdown |
| [Texto completo de la documentación](/es/docs/llms-full.txt) | Leer todas las páginas de una vez; el contenido es largo, se recomienda leer página por página |
| [Markdown de la página de inicio](/es/docs/index.md) | Leer el contenido del documento de origen sin la navegación del sitio |
Cada artículo tiene una dirección Markdown correspondiente, por ejemplo `/es/docs/quickstart-claude-code/` corresponde a `/es/docs/quickstart-claude-code.md`. También puede usar "Copiar esta página" en la parte superior de la página. El Markdown puede conservar marcadores de componentes de documentación como tarjetas.
## Tareas de integración para la IA
Copie las instrucciones de la tarea para que el asistente primero consulte el alcance de compatibilidad y luego configure y verifique. Elija el protocolo, la dirección y la configuración del modelo según la herramienta.
## Estado del MCP de documentación
Este sitio actualmente no ofrece un servidor MCP de documentación al que conectarse. Utilice primero las direcciones de documentación anteriores, o copie el contenido de la página al asistente; no confunda la Base URL de la API del modelo con la dirección MCP.
El propósito del MCP de documentación es buscar y leer materiales públicos. Las operaciones como consultas de cuenta y gestión de claves pertenecen a otra categoría de capacidades y no se pueden obtener a través de la entrada de documentación pública.
---
# Deja que la IA te ayude a integrar
Source: https://1zheai.com/es/docs/agent-workflow/
Markdown: https://1zheai.com/es/docs/agent-workflow.md
---
title: "Deja que la IA te ayude a integrar"
description: "Instrucciones de tarea copiables que ayudan a la IA a leer primero la documentación, verificar las restricciones y luego completar la configuración y la verificación."
headingIds: {"Instrucciones de tarea copiables":"section-1","Cómo determinar si está completado":"section-2"}
---
## Instrucciones de tarea copiables
Pasa las siguientes instrucciones a un asistente de IA capaz de leer páginas web, y añade el nombre de la herramienta y el sistema operativo. Si el asistente no tiene acceso a internet, primero obtén el contenido del artículo correspondiente a través de la [entrada de lectura automática](/es/docs/ai/).
```text
请帮助我将现有工具或应用接入 1折AI。
目标工具与版本：[填写]
操作系统或编程语言：[填写]
先读取 https://1zheai.com/es/docs/llms.txt，找到目标工具或 SDK 的文档。
再读取该页 Markdown，以及 API 参考和模型说明。
要求：
1. 先说明当前支持范围和工具配置要求。
2. 根据目标工具确定 Base URL，不要统一添加或删除 /v1。
3. 模型 ID 以当前文档和密钥可用模型列表为准，不要猜测。
4. 查看现有配置，只修改必要字段，保留其他供应商配置。
5. 使用环境变量或工具提供的凭据存储方式；不要把密钥写入源码、
对话、日志或提交记录。需要密钥时，让我在本地安全配置。
6. 执行会产生费用的测试前，说明测试内容并取得我的同意。
7. 用一次最小请求验证，再提示我在调用日志里核对记录。
8. 如果验证失败，保留脱敏的状态码与请求 ID，按排错文档处理；
不要用反复重试掩盖配置问题。
9. 最后说明修改位置、验证结果、剩余限制及恢复原配置的方法。
```
## Cómo determinar si está completado
Completar la configuración no equivale a completar la integración. Debes confirmar simultáneamente que la herramienta devuelve resultados normales, que el modelo realmente utilizado coincide con lo esperado y que puedes encontrar el registro correspondiente en el [registro de llamadas](/es/docs/usage-logs/).
Esta página es una instrucción de tarea copiable, no una Agent Skill instalada ni un servicio MCP. Cualquier asistente aún necesita poseer las capacidades correspondientes para leer documentación y manipular la configuración local.
---