Saltar para o conteúdo principal

​
Introdução

Claude é um serviço de chat AI fornecido pela Ace Data Cloud, baseado na série de grandes modelos de linguagem Anthropic Claude. Através da API unificada da Ace Data Cloud, você pode integrar rapidamente o Claude usando Python, implementando funcionalidades como diálogo multi-turno, prompts do sistema, saída em streaming, modo de saída JSON, entre outras.

​
Pré-requisitos

  • Possuir uma conta Ace Data Cloud e obter o Token da API
  • Ambiente Python 3.7 ou superior
  • Instalar a biblioteca requests: pip install requests

​
Uso Básico

O endpoint principal para chamar a API Claude é: 
POST https://api.acedata.cloud/v1/chat/completions
Este exemplo utiliza o modelo claude-sonnet-4-6.
Modelos disponíveis incluem: claude-sonnet-4-6, claude-opus-4-5-20251101, claude-3-5-sonnet. Exemplo completo em Python: 
import requests

url = "https://api.acedata.cloud/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "model": "claude-sonnet-4-6",
    "messages": [
        {
            "role": "user",
            "content": "你好，请介绍一下你自己"
        }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Tratamento da Resposta

Após uma chamada bem-sucedida, a API retorna dados no formato JSON. Recomenda-se verificar o código de status HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chamada bem-sucedida:", result)
else:
    print(f"Falha na chamada, código de status: {response.status_code}")
    print(response.text)

​
Uso Avançado

Para APIs de chat, é suportada saída em streaming para receber respostas em tempo real: 
import requests

data['stream'] = True
response = requests.post(url, headers=headers, json=data, stream=True)
for line in response.iter_lines():
    if line:
        print(line.decode())

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o Token da API
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Outros Endpoints

O serviço Claude também oferece os seguintes endpoints:
  • POST https://api.acedata.cloud/v1/messages
  • POST https://api.acedata.cloud/v1/messages/count_tokens

​
Próximos Passos