---
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/).