Pular para o conteúdo
Documentação 1ZheAI
Português

Início rápido

Crie uma chave de API da 1zheai, faça a primeira chamada a Claude / GPT com curl ou SDK e integre em clientes comuns.

Objetivo: obter uma chave de API (API key) em 5 minutos e concluir a primeira requisição a Claude ou GPT.

  1. Registrar e recarregar

    Abra 1zheai.com/register para se registrar. As chamadas são cobradas por consumo de saldo, portanto é necessário recarregar primeiro. O saldo é contabilizado em dólares (USD), com suporte a WeChat Pay, Alipay, Stripe (cartão de crédito) e USDT; os métodos específicos e os limites de valor são definidos pela página de pedido da carteira. Após a recarga, dentro de 7 dias é possível solicitar o reembolso do principal não utilizado pela mesma via de pagamento; a parte já consumida e as taxas de processamento de pagamento não são reembolsadas. As regras estão em Recarga, reembolso e fatura.

  2. Criar chave da API

    Entre no console, no menu lateral clique em “Chave de API”, depois clique em “Criar chave de API” no canto superior direito, informe um nome e salve. A chave de API começa com sk-; na lista, clique no ícone de copiar para copiá-la e guarde-a. Detalhes em Obter e gerenciar chaves de API.

  3. Enviar a primeira requisição

    Coloque a chave de API em uma variável de ambiente e use o curl para chamar a interface nativa da Anthropic:

    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 é apenas um nome de variável de exemplo; qualquer nome pode ser usado.

  4. Ver resposta

    Em caso de sucesso, retorna HTTP 200, com estrutura idêntica à oficial. Observe dois pontos: se model corresponde ao modelo solicitado e a quantidade de tokens em usage. Abaixo está a resposta real testada em 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 é maior do que a própria pergunta em algumas centenas, pois é o prompt de sistema anexado a cada requisição desse tipo de cliente (curl, SDK, ferramentas de terceiros), cobrado como entrada; o Claude Code não o anexa, veja Cobrança do prompt de sistema.

    Em seguida, no menu lateral do console, em “Log de chamadas”, é possível ver esta chamada: horário, chave de API utilizada (coluna “Token”), modelo, tokens de entrada / saída, leitura e escrita de cache e custo.

Também é possível começar pelo GPT

Seção intitulada "Também é possível começar pelo GPT"

Se você usa a OpenAI SDK ou pretende integrar ao Codex, pode escolher diretamente o protocolo GPT. Primeiro defina o ONEZHE_API_KEY mencionado acima no mesmo terminal e depois execute:

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 é um exemplo de shell em macOS / Linux; no Windows, execute diretamente exemplos multiplataforma em Python / Node.js. O texto está em choices[0].message.content; se o modelo não estiver na sua lista, consulte primeiro modelos disponíveis. O Codex requer Responses; integre conforme tutorial de configuração do Codex.

Próximos passos

Seção intitulada "Próximos passos"

Integre nas ferramentas que você usa com frequência:

Claude Code

Duas variáveis de ambiente são suficientes.

CC Switch

Use-o se não quiser editar manualmente os arquivos de configuração.

Cursor

Formas de definir Base URL personalizada e suas restrições.

OpenAI SDK

Se você já tem código OpenAI, altere apenas o base_url.

Se a requisição falhar, consulte primeiro códigos de erro e solução de problemas. Para conferir os campos retornados e o consumo, veja verificar modelo e uso.