Criar Mensagem

Visão geralCopy Anchor Link

Este endpoint fornece compatibilidade nativa com a Anthropic Messages API. Use isto para modelos Claude com recursos como pensamento estendido.

Este endpoint mantém o contrato nativo da Anthropic. messages deve ser um array de mensagens user / assistant, system fica no campo de nível superior system, e max_tokens é obrigatório. Se o payload usar papéis da OpenAI como system, developer ou tool dentro de messages, envie para /v1/chat/completions.

Cabeçalhos da requisiçãoCopy Anchor Link

Corpo da requisiçãoCopy Anchor Link

RespostaCopy Anchor Link

curl -X POST "https://api.tokenlab.sh/v1/messages" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "You are a helpful assistant.",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "model": "claude-sonnet-5",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 10
  }
}

Exemplo de Entrada de VisãoCopy Anchor Link

Para modelos Claude com suporte a visão, coloque imagens dentro de messages[].content como blocos de imagem estruturados.

{
  "model": "claude-sonnet-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Please describe this image."
        },
        {
          "type": "image",
          "source": {
            "type": "url",
            "url": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}

{
  "model": "claude-sonnet-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Please describe this image."
        },
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Exemplo de pensamento estendidoCopy Anchor Link

Defina TOKENLAB_THINKING_MODEL como um modelo que suporte thinking manual com type: "enabled" e budget_tokens. Ajuste os dois orçamentos de tokens aos limites desse modelo. Outros modelos podem exigir uma configuração de thinking diferente.

import os
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh"
)

message = client.messages.create(
    model=os.environ["TOKENLAB_THINKING_MODEL"],
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[{"role": "user", "content": "Solve this math problem..."}]
)

for block in message.content:
    if block.type == "thinking":
        print(f"Thinking: {block.thinking}")
    elif block.type == "text":
        print(f"Response: {block.text}")

Lotes de mensagens da AnthropicCopy Anchor Link

O TokenLab agora expõe o fluxo nativo de Anthropic Message Batches junto com /v1/messages.

Rotas disponíveis:

• POST /v1/messages/batches
• GET /v1/messages/batches
• GET /v1/messages/batches/:message_batch_id
• GET /v1/messages/batches/:message_batch_id/results
• POST /v1/messages/batches/:message_batch_id/cancel
• DELETE /v1/messages/batches/:message_batch_id

Notas operacionais:

• Use a mesma chave de API do TokenLab junto com os cabeçalhos nativos da Anthropic.
• Se os itens do batch fizerem referência a file_id, inclua também anthropic-beta: files-api-2025-04-14.
• Os batch jobs mantêm o formato nativo de requisição/resposta da Anthropic, enquanto o TokenLab acompanha internamente o ciclo de liquidação.