Responses API do Muitto

Primeira requisição

Consulte GET /models primeiro com read:catalog para descobrir IDs de modelos de texto.

curl https://muitto.app/api/public/v1/models \
  -H "Authorization: Bearer lv_mcp_YOUR_TOKEN"

Os IDs são slugs reais do catálogo. Faça GET /models com read:catalog e use um id retornado; não adivinhe nomes de modelos.

curl https://muitto.app/api/public/v1/responses \
  -H "Authorization: Bearer lv_mcp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: REQUEST_UUID" \
  -d '{"model":"MODEL_FROM_GET_MODELS","input":"Hello from Muitto"}'

import { randomUUID } from "node:crypto";
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MUITTO_TOKEN,
  baseURL: "https://muitto.app/api/public/v1",
  maxRetries: 0,
});

const response = await client.responses.create({
  model: "MODEL_FROM_GET_MODELS",
  instructions: "Be concise.",
  input: "Hello from Muitto",
}, { headers: { "Idempotency-Key": randomUUID() } });
console.log(response.output_text);

import os
import uuid
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MUITTO_TOKEN"],
    base_url="https://muitto.app/api/public/v1",
    max_retries=0,
)
response = client.responses.create(
    model="MODEL_FROM_GET_MODELS",
    input="Hello from Muitto",
    extra_headers={"Idempotency-Key": str(uuid.uuid4())},
)
print(response.output_text)

Entrada e parâmetros

input aceita uma string ou itens de mensagem com conteúdo de texto. instructions vira uma mensagem de sistema no provedor. Imagens, áudio e outros itens multimodais não são aceitos.

{
  "model": "MODEL_FROM_GET_MODELS",
  "instructions": "Optional system guidance",
  "input": "A text string",
  "max_output_tokens": 1024,
  "temperature": 0.2,
  "top_p": 0.9,
  "store": false
}

Os parâmetros aceitos são validados estritamente. Campos desconhecidos retornam erro 400 com uma mensagem explícita.

Streaming buffered

O provedor conclui e a cobrança é liquidada antes de o endpoint emitir o stream. Os eventos são eventos semânticos genuínos do Responses, mas o texto e os argumentos de função são agrupados em deltas completos; isso não é streaming de tokens em tempo real.

const stream = client.responses.stream({
  model: "MODEL_FROM_GET_MODELS",
  input: "Hello",
}, { headers: { "Idempotency-Key": randomUUID() } });
for await (const event of stream) console.log(event.type);
const response = await stream.finalResponse();

A sequência inclui response.created, response.in_progress, eventos de item e parte, deltas de texto ou argumentos e eventos done. response.completed é emitido somente para uma resposta concluída; um limite de saída ou filtro de conteúdo termina em response.incomplete com o motivo correspondente. Cada evento tem ID estável e número de sequência.

Limites e estados

O corpo da requisição é limitado a 8 MB, a entrada estimada a 2 milhões de tokens e max_output_tokens a 1 milhão. O limite é de 60 requisições por minuto por token e por instância. O stream é emitido depois da conclusão do provedor e da liquidação da cobrança.