Responses API

​

Quando usarlo

​

Guida rapida

curl https://api.venice.ai/api/v1/responses \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "input": "Explain why the sky is blue in one sentence.",
    "venice_parameters": { "include_venice_system_prompt": false }
  }'

from openai import OpenAI

client = OpenAI(base_url="https://api.venice.ai/api/v1", api_key="YOUR_VENICE_API_KEY")

response = client.responses.create(
    model="venice-uncensored",
    input="Explain why the sky is blue in one sentence.",
    extra_body={"venice_parameters": {"include_venice_system_prompt": False}},
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.venice.ai/api/v1", apiKey: process.env.VENICE_API_KEY });

const response = await client.responses.create({
  model: "venice-uncensored",
  input: "Explain why the sky is blue in one sentence.",
  venice_parameters: { include_venice_system_prompt: false },
});
console.log(response.output_text);

{
  "id": "resp_...",
  "object": "response",
  "model": "venice-uncensored-1-2",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "id": "msg_...",
      "role": "assistant",
      "status": "completed",
      "content": [{ "type": "output_text", "text": "Sunlight scatters off air molecules...", "annotations": [] }]
    }
  ],
  "usage": { "input_tokens": 18, "output_tokens": 21, "total_tokens": 39 }
}

​

Come vengono servite le richieste

• Nativa. Le richieste per i modelli OpenAI vengono inoltrate alla Responses API di OpenAI senza traduzione. Questo vale per tutti i modelli openai-* tranne openai-gpt-oss-120b. Elementi della risposta, ID, ragionamento ed eventi dello stream vengono restituiti esattamente come li restituisce OpenAI.
• Tradotta. Tutti gli altri modelli, più openai-gpt-oss-120b, passano attraverso un livello di traduzione: Venice converte la richiesta in una richiesta Chat Completions, la esegue e riconverte il risultato. Tutto ciò che il formato Chat Completions non può esprimere viene ignorato o rifiutato. Vedi Limitazioni.

​

Le conversazioni sono stateless

history = [{"role": "user", "content": "What is the weather in Paris? Use the tool."}]
tools = [{
    "type": "function",
    "name": "get_weather",
    "description": "Get the current weather for a city",
    "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]},
}]

first = client.responses.create(model="venice-uncensored", input=history, tools=tools)
call = next(item for item in first.output if item.type == "function_call")

history += first.output
history.append({"type": "function_call_output", "call_id": call.call_id, "output": '{"temp_c": 18}'})

second = client.responses.create(model="venice-uncensored", input=history, tools=tools)
print(second.output_text)

​

Modalità nativa

• instructions, applicate così come sono scritte.
• Structured output con text.format. OpenAI valida gli schemi in modo rigoroso, quindi uno schema non valido restituisce 400. Ad esempio, strict: true richiede additionalProperties: false, e json_object richiede la parola “json” da qualche parte nell’input.
• Function tool e tool_choice nella forma Responses di OpenAI {"type": "function", "name": "..."}, oltre alle chiamate parallele ai tool.
• Tool eseguiti dal client: custom (input in formato libero), namespace, tool_search, apply_patch, shell e local_shell con un ambiente locale, e computer use.
• Riepiloghi del ragionamento, attivi per impostazione predefinita. I modelli di ragionamento restituiscono sempre encrypted_content sugli elementi di ragionamento. Rimanda quegli elementi in input al turno successivo per mantenere il contesto di ragionamento del modello.
• Prompt caching con prompt_cache_key. Venice limita la chiave al tuo account, quindi non condivide mai una cache con altri utenti, e restituisce la tua chiave originale nella risposta.
• Input di immagini, incluso detail: "original", e input_file con file_data inline.
• Modelli Pro (*-pro), che eseguono automaticamente la modalità di ragionamento Pro di OpenAI.

​

Streaming

• Il testo del ragionamento viene trasmesso come response.reasoning.delta, non tramite gli eventi di riepilogo del ragionamento di OpenAI.
• Quando viene eseguita la ricerca web, un evento response.web_search.done trasporta i risultati della ricerca prima che venga trasmessa la risposta.

​

Parametri della modalità tradotta

• Le instructions vengono applicate come messaggio di sistema.
• I tool custom restituiscono elementi custom_tool_call con l’input grezzo. Se un modello restituisce argomenti malformati per un tool custom, o chiama un tool non dichiarato nella richiesta, la chiamata viene restituita come un normale function_call con gli argomenti originali, così il tuo client può segnalare un errore del tool e proseguire.
• Mentre l’input di un tool custom viene trasmesso in streaming, il relativo elemento di chiamata e gli elementi successivi possono arrivare solo dopo che l’input è completo. Durante l’attesa, lo stream invia commenti SSE keep-alive.
• L’immagine con detail: "original" viene inviata come high ai provider che non lo supportano.

​

Limitazioni

​

Risorse correlate

• Riferimento API per POST /responses
• Function calling
• Modelli di ragionamento
• Guida alla migrazione da OpenAI