Saltar al contenido
Documentación 1ZheAI
Español

Inicio rápido

Crea una clave API de 1zheAI, llama a Claude / GPT con curl o SDK e intégralo en tus clientes habituales.

Objetivo: obtener una clave API (API key) en 5 minutos y completar tu primera solicitud a Claude o GPT.

  1. Registrarse y recargar

    Abre 1zheai.com/register 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 enRecargas, reembolsos e facturas.

  2. Crear clave API

    Entra enConsola, 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 enObtener y gestionar claves API.

  3. Enviar la primera solicitud

    Coloca la clave API en una variable de entorno y llama una vez a la interfaz nativa de Anthropic con curl:

    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"}]
      }'

    ONEZHE_API_KEY es solo un nombre de variable de ejemplo; puedes usar el que quieras.

  4. Ver la respuesta

    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; verFacturación del aviso de sistema.

    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

Sección titulada “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 losejemplos multiplataforma en Python / Node.js. El texto está en choices[0].message.content; si el modelo no está en tu lista, consulta anteslos modelos disponibles. Codex necesita Responses; intégralo según eltutorial de configuración de Codex.

Siguiente paso

Sección titulada “Siguiente paso”

Conéctalo a tus herramientas habituales:

Claude Code

Dos variables de entorno bastan.

CC Switch

Úsalo si no quieres editar a mano los archivos de configuración.

Cursor

Forma de escribir y restricciones de la Base URL personalizada.

OpenAI SDK

Si ya tienes código de OpenAI, solo cambia base_url.

Si la solicitud falla, consulta primerolos códigos de error y la resolución de problemas. Para verificar los campos devueltos y el uso, consultaverificar modelo y uso.