Responses API

​

Cuándo usarlo

​

Inicio rápido

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 }
}

​

Procesamiento de las solicitudes

• Nativo. Las solicitudes para modelos de OpenAI se reenvían a la Responses API de OpenAI sin traducción. Esto abarca todos los modelos openai-* excepto openai-gpt-oss-120b. Los elementos de respuesta, los ID, el razonamiento y los eventos de streaming se devuelven exactamente como los devuelve OpenAI.
• Traducido. Todos los demás modelos, además de openai-gpt-oss-120b, pasan por una capa de traducción: Venice convierte la solicitud en una solicitud de Chat Completions, la ejecuta y vuelve a convertir el resultado. Todo lo que el formato Chat Completions no puede expresar se ignora o se rechaza. Consulta Limitaciones.

​

Las conversaciones no tienen estado

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)

​

Modo nativo

• instructions, aplicadas tal como están escritas.
• Salidas estructuradas con text.format. OpenAI valida los esquemas de forma estricta, por lo que un esquema no válido devuelve 400. Por ejemplo, strict: true requiere additionalProperties: false, y json_object requiere que la palabra “json” aparezca en algún lugar del input.
• Herramientas de función y tool_choice en la forma de Responses de OpenAI {"type": "function", "name": "..."}, además de llamadas a herramientas en paralelo.
• Herramientas ejecutadas por el cliente: custom (entrada de formato libre), namespace, tool_search, apply_patch, shell y local_shell con un entorno local, y computer use.
• Resúmenes de razonamiento, activados por defecto. Los modelos de razonamiento siempre devuelven encrypted_content en los elementos de razonamiento. Devuelve esos elementos en input en el siguiente turno para conservar el contexto de razonamiento del modelo.
• Caché de prompts con prompt_cache_key. Venice limita la clave a tu cuenta, de modo que nunca comparte una caché con otros usuarios, y devuelve tu clave original en la respuesta.
• Entradas de imagen, incluido detail: "original", e input_file con file_data en línea.
• Modelos Pro (*-pro), que ejecutan automáticamente el modo de razonamiento Pro de OpenAI.

​

Streaming

• El texto de razonamiento se transmite como response.reasoning.delta, no como los eventos de resumen de razonamiento de OpenAI.
• Cuando se ejecuta la búsqueda web, un evento response.web_search.done lleva los resultados de búsqueda antes de que se transmita la respuesta.

​

Parámetros del modo traducido

• Las instructions se aplican como un mensaje de sistema.
• Las herramientas personalizadas devuelven elementos custom_tool_call con el input sin procesar. Si un modelo devuelve argumentos mal formados para una herramienta personalizada, o llama a una herramienta que no está declarada en la solicitud, la llamada se devuelve como un function_call normal con los argumentos originales, para que tu cliente pueda informar de un error de herramienta y continuar.
• Mientras se transmite el input de una herramienta personalizada, su elemento de llamada y los elementos posteriores pueden llegar solo después de que el input esté completo. El stream envía comentarios SSE de keep-alive mientras espera.
• detail: "original" de las imágenes se envía como high a los proveedores que no lo admiten.

​

Limitaciones

​

Relacionado

• Referencia de la API para POST /responses
• Llamada a funciones
• Modelos de razonamiento
• Guía de migración desde OpenAI