Vai al contenuto principale
OrcaRouter espone una superficie OpenAI di prima classe. Punta il tuo SDK OpenAI esistente al base URL di OrcaRouter e il tuo codice continuerà a funzionare come l’SDK si aspetta — streaming, tool calling, output strutturati (json_object e json_schema) e vision sono tutti supportati. Quando scegli come target un modello di un provider diverso, il livello di traduzione di OrcaRouter adatta richiesta e risposta alla forma nativa di quel provider, in modo che il codice del tuo SDK resti invariato.

​
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 asincrono

from openai import AsyncOpenAI

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

​
Usare le variabili d’ambiente

L’SDK OpenAI legge OPENAI_API_KEY e OPENAI_BASE_URL per impostazione predefinita. Impostale una volta e l’SDK le rileverà senza configurazione per chiamata: 
export OPENAI_API_KEY="sk-orca-..."
export OPENAI_BASE_URL="https://api.orcarouter.ai/v1"

​
Cosa cambia nel tuo codice

Solo il base URL e la chiave API. Parametri della richiesta, forma della risposta, protocollo di streaming, gestione degli errori — tutto invariato. I nomi dei modelli sono prefissati con il provider (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) così i client sanno sempre quale provider ha servito la richiesta; OrcaRouter gestisce la traduzione tra provider internamente attraverso lo stesso oggetto client. La web search funziona con l’SDK OpenAI verso OrcaRouter. Vedi Avanzato / Web search per le forme dei parametri per endpoint e quali modelli la supportano.

​
Altri SDK

Stai usando direttamente l’SDK Anthropic o l’SDK google-genai? Vedi Compatibilità / Anthropic SDK e Compatibilità / Google GenAI SDK.