---
title: "Início rápido"
description: "Crie uma chave de API da 1zheai, faça a primeira chamada a Claude / GPT com curl ou SDK e integre em clientes comuns."
headingIds: {"Também é possível começar pelo GPT":"section-1","Próximos passos":"section-2"}
---
Objetivo: obter uma chave de API (API key) em 5 minutos e concluir a primeira requisição a Claude ou GPT.
Abra [1zheai.com/register](https://1zheai.com/register?lng=pt) 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](/pt/docs/billing/).
Entre no [console](https://1zheai.com/console?lng=pt), 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](/pt/docs/api-keys/).
Coloque a chave de API em uma variável de ambiente e use o curl para chamar a interface nativa da Anthropic:
```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` é apenas um nome de variável de exemplo; qualquer nome pode ser usado.
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](/pt/docs/pricing-explained/#section-3).
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 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](/pt/docs/code-examples/). O texto está em `choices[0].message.content`; se o modelo não estiver na sua lista, consulte primeiro [modelos disponíveis](/pt/docs/api-models/). O Codex requer Responses; integre conforme [tutorial de configuração do Codex](/pt/docs/quickstart-codex/).
## Próximos passos
Integre nas ferramentas que você usa com frequência:
Duas variáveis de ambiente são suficientes.
Use-o se não quiser editar manualmente os arquivos de configuração.
Formas de definir Base URL personalizada e suas restrições.
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](/pt/docs/troubleshooting/). Para conferir os campos retornados e o consumo, veja [verificar modelo e uso](/pt/docs/verify-model/).