Documentação da API

Acesso unificado aos melhores modelos de AI. API compatível com OpenAI — uma chave para todos os modelos.

URL Base da API

https://tokenhub.store/api/v1

Todas as requisições da API usam esta URL base. Totalmente compatível com SDKs OpenAI.

Início Rápido

Comece em Minutos

  1. Crie uma conta e faça login no seu Dashboard
  2. Acesse API Keys e crie uma nova API key
  3. Visite Cobrança para adicionar Credits à sua conta
  4. Comece a fazer chamadas de API com qualquer model suportado

Models Suportados

Clique em um provider para ver os models disponíveis e exemplos de código.

OpenAI

6 modelos

Empresa líder em pesquisa de AI, criadora da série GPT. Conhecida por models de linguagem de última geração com capacidades excepcionais de raciocínio e programação.

Anthropic

6 modelos

Empresa de segurança em AI conhecida pelos models Claude. Excelente em conversas nuançadas, código e raciocínio complexo, com fortes recursos de segurança.

Google

5 modelos

A família Gemini do Google oferece capacidades multimodais de ponta com janelas de contexto líderes do setor de até 2M Tokens.

xAI

3 modelos

Empresa de AI de Elon Musk. Os models Grok são conhecidos por conhecimento em tempo real, respostas espirituosas e excelente assistência em programação.

Alibaba (Qwen)

3 modelos

A série Qwen da Alibaba oferece models multilíngues poderosos, com ótimo desempenho em tarefas em inglês e chinês.

Zhipu AI (GLM)

3 modelos

A série GLM da Zhipu AI. Models bilíngues avançados em chinês e inglês, com janela de contexto de até 200K.

MiniMax

2 modelos

A série M2 da MiniMax. Contexto ultralongo de 205K com fortes capacidades multilíngues.

Xiaomi (MiMo)

2 modelos

Models MiMo V2 da Xiaomi. Janelas de contexto grandes de até 1M Tokens.

Alibaba (Qwen3)

3 modelos

A série Qwen3 da Alibaba. Massive models MoE com especializações em visão-linguagem e código.

Moonshot AI (Kimi)

3 modelos

A série Kimi K2 da Moonshot AI. Raciocínio forte com janelas de contexto estendidas.

DeepSeek

6 modelos

Os models mais recentes da DeepSeek. Altamente econômicos, com fortes capacidades de raciocínio e código.

ByteDance (Seedance)

2 modelos

Models de geração de vídeo Seedance da ByteDance. Text-to-video com qualidade cinematográfica, image-to-video e edição de vídeo multimodal com suporte a áudio.

ByteDance (Seedream)

3 modelos

Models de geração de imagem Seedream da ByteDance. Text-to-image de alta qualidade com estilos fotorealistas e artísticos.

Kwaivgi (Kling)

2 modelos

Models de geração de vídeo Kling da Kwaivgi. Text-to-video e image-to-video de alta qualidade com modos std/pro. Durações de 3–15s. std: $0.168/s, pro: $0.224/s (sem áudio).

Endpoints da API

POST /chat/completions

Crie uma conclusão de chat com suporte a streaming

Cabeçalhos

headers
Authorization: Bearer th-your-api-key
Content-Type: application/json

Corpo da Solicitação

json
{
  "model": "openai/gpt-4.1",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"}
  ],
  "temperature": 0.7,
  "max_tokens": 1000,
  "stream": false
}

POST /videos/generations

Gere um vídeo a partir de um prompt de texto ou imagem (models Seedance & Wan 2.2)

Cabeçalhos

headers
Authorization: Bearer th-your-api-key
Content-Type: application/json

Corpo da Solicitação

json
{
  "model": "bytedance/doubao-seedance-2.0",
  "prompt": "A golden retriever running on a sunny beach",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Corpo da Solicitação (array de content — first_frame & last_frame)

json
{
  "model": "bytedance/doubao-seedance-2.0",
  "prompt": "Hand picks a fresh apple from the tree, the scene smoothly transitions to a hand holding an apple smoothie drink, cinematic lighting in an orchard",
  "content": [
    {
      "type": "image_url",
      "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg" },
      "role": "first_frame"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg" },
      "role": "last_frame"
    }
  ],
  "duration": 5,
  "resolution": "720p"
}

Parâmetros

content (opcional): Array de assets de mídia. Cada item tem:

  • type: "image_url"
  • image_url.url: URL da imagem
  • role: <firstFrame/> (máx. 1), <lastFrame/> (máx. 1), <refImage/>, <refVideo/>, <refAudio/>

GET /videos/generations/{id}

Consultar o status de uma tarefa de geração de vídeo

Cabeçalhos

headers
Authorization: Bearer th-your-api-key

Resposta

json
{
  "id": "tsk-xxx",
  "object": "video.generation.task",
  "model": "bytedance/doubao-seedance-2.0",
  "status": "succeeded",  // "queued" | "running" | "succeeded" | "failed"
  "data": [
    {
      "video_url": "https://..."
    }
  ]
}

POST /images/generations

Gere imagens a partir de prompts de texto (modelos Seedream)

Cabeçalhos

headers
Authorization: Bearer th-your-api-key
Content-Type: application/json

Corpo da requisição

json
{
  "model": "bytedance/doubao-seedream-5.0",
  "prompt": "A serene mountain landscape at sunset",
  "n": 1,
  "size": "2048x2048"
}

GET /models

Liste todos os modelos disponíveis

Exemplos de Código

cURL

bash
curl https://tokenhub.store/api/v1/chat/completions \
  -H "Authorization: Bearer th-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Python (OpenAI SDK)

python
from openai import OpenAI

client = OpenAI(
    api_key="th-your-api-key",
    base_url="https://tokenhub.store/api/v1"
)

# Use any supported model
response = client.chat.completions.create(
    model="openai/gpt-5.4",  # Or any other model
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

JavaScript / TypeScript

typescript
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'th-your-api-key',
  baseURL: 'https://tokenhub.store/api/v1',
});

// Use any supported model
const response = await client.chat.completions.create({
  model: 'anthropic/claude-sonnet-4-6',
  messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(response.choices[0].message.content);

Exemplo de Streaming (Python)

python
from openai import OpenAI

client = OpenAI(
    api_key="th-your-api-key",
    base_url="https://tokenhub.store/api/v1"
)

stream = client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Write a short story."}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Precisa de ajuda?

Entre em contato: support@tokenhub.store