Saltar para o conteúdo principal
O OrcaRouter expõe uma superfície de primeira classe da OpenAI. Aponte seu SDK da OpenAI existente para a base URL do OrcaRouter e seu código continua funcionando como o SDK espera — streaming, chamada de ferramentas, saídas estruturadas (json_object e json_schema) e visão são todos suportados. Quando você mira em um modelo de um provedor diferente, a camada de tradução do OrcaRouter adapta requisição e resposta para o formato nativo daquele provedor, então seu código no SDK permanece inalterado.

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.orcarouter.ai/v1",
    api_key="sk-orca-...",
)

TypeScript / Node

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.orcarouter.ai/v1",
  apiKey: "sk-orca-...",
});

Python assíncrono

from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://api.orcarouter.ai/v1",
    api_key="sk-orca-...",
)

Usando variáveis de ambiente

O SDK da OpenAI lê OPENAI_API_KEY e OPENAI_BASE_URL por padrão. Defina-as uma vez e o SDK as utiliza sem configuração por chamada:
export OPENAI_API_KEY="sk-orca-..."
export OPENAI_BASE_URL="https://api.orcarouter.ai/v1"

O que muda no seu código

Apenas a base URL e a chave de API. Parâmetros de requisição, formato de resposta, protocolo de streaming, tratamento de erros — tudo inalterado. Os nomes de modelo são com prefixo de provedor (openai/gpt-4o-mini, anthropic/claude-sonnet-4.6, google/gemini-2.5-pro, deepseek/deepseek-chat, grok/grok-4-fast-reasoning, qwen/qwen3.6-plus, kimi/kimi-k2.6, minimax/minimax-m2.7), de modo que os clientes sempre sabem qual provedor serviu a requisição; o OrcaRouter trata a tradução entre provedores internamente através do mesmo objeto cliente. A busca web funciona com o SDK da OpenAI contra o OrcaRouter. Veja Avançado / Busca web para os formatos de parâmetros por endpoint e quais modelos a suportam.

Outros SDKs

Usando o SDK da Anthropic ou o SDK google-genai diretamente? Veja Compatibilidade / SDK da Anthropic e Compatibilidade / SDK Google GenAI.