Chaves API

As chaves API são usadas para autenticar suas solicitações às APIs do Atlas Cloud. Cada chamada API requer uma chave API válida.

Criar uma chave API

1. Acesse API Keys
2. Clique em Criar chave API
3. Copie sua nova chave API e guarde-a com segurança

Sua chave API será mostrada apenas uma vez quando criada. Se você perdê-la, precisará criar uma nova.

Usando sua chave API

Inclua sua chave API no cabeçalho Authorization de cada solicitação API:

Authorization: Bearer your-api-key

LLM / Completação de chat (compatível com OpenAI)

URL base: https://api.atlascloud.ai/v1

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.atlascloud.ai/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "Hello!"}]
)

Geração de imagens / vídeos

URL base: https://api.atlascloud.ai/api/v1

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateImage",
    headers={"Authorization": "Bearer your-api-key"},
    json={
        "model": "seedream-3.0",
        "prompt": "A cat sitting on a rainbow"
    }
)

Enviar mídia

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("photo.jpg", "rb")}
)

# Retorna uma URL temporaria para uso com tarefas de geracao
print(response.json())

Integração com ferramentas de terceiros

Você pode usar sua chave API do Atlas Cloud com qualquer ferramenta ou aplicação compatível com OpenAI. As opções populares incluem:

Ao configurar ferramentas de terceiros:

• Host API / URL base: https://api.atlascloud.ai/v1 (o sufixo /v1 é obrigatório)
• Chave API: Sua chave API do Atlas Cloud
• Nome do modelo: Qualquer modelo da Biblioteca de modelos

Melhores práticas de segurança

• Nunca compartilhe sua chave API ou a inclua no controle de versão
• Use variáveis de ambiente para armazenar sua chave API:

  export ATLASCLOUD_API_KEY="your-api-key"

• Rotacione as chaves regularmente — exclua chaves antigas e crie novas
• Use chaves separadas para ambientes de desenvolvimento e produção
• Monitore o uso no Console para detectar uso não autorizado

Gerenciamento de chaves

Você pode gerenciar suas chaves API em Configurações da conta:

• Criar — Gere novas chaves API conforme necessário
• Excluir — Revogue chaves API que não são mais necessárias ou que possam ter sido comprometidas
• Ver uso — Monitore o uso e os custos da API associados a cada chave

Limites de taxa

Os limites de taxa da API variam por nível de conta e tipo de modelo. Se você encontrar erros de limite de taxa (429 Too Many Requests), considere:

• Adicionar um pequeno atraso entre as solicitações
• Usar backoff exponencial para retentativas
• Contatar [email protected] para limites mais altos