Texto y audio con IA desde una sola API

Authorization: Bearer talo_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

X-API-Key: talo_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

curl -sS https://ai.test.talo.systems/v1/generate \
  -H "Authorization: Bearer $TALO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "function": "text.standard",
        "operation": "soporte.resumen",
        "input": "Resume en una frase: el cliente reporta que la app se cierra al pagar."
      }'

{
  "request_id": "req_01JC8Z4R6M2V8K3N5P7Q9S1T3W",
  "function": "text.standard",
  "provider": "anthropic",
  "resolved_model": "anthropic/claude-haiku-5-5",
  "output": [{ "type": "text", "text": "La app se cierra durante el proceso de pago." }],
  "finish_reason": "stop",
  "usage": { "input_tokens": 31, "output_tokens": 12, "source": "provider" },
  "cost": { "amount_micros": 10, "currency": "USD", "billing_status": "confirmed", "price_version": "anthropic-2026-10-06" },
  "duration_ms": 842,
  "warnings": []
}

use Illuminate\Support\Facades\Http;

$res = Http::withToken(env('TALO_API_KEY'))
    ->timeout(120)
    ->post(env('TALO_AI_URL') . '/v1/generate', [
        'function'  => 'text.standard',
        'operation' => 'crm.resumen_llamada',
        'input'     => $transcripcion,
    ]);

if ($res->failed()) {
    $error = $res->json('error'); // code, message, request_id, retryable
    throw new RuntimeException("TALO AI {$error['code']}: {$error['message']} ({$error['request_id']})");
}

$texto = collect($res->json('output'))->where('type', 'text')->pluck('text')->implode('');

import os
import requests

res = requests.post(
    f"{os.environ['TALO_AI_URL']}/v1/generate",
    headers={"Authorization": f"Bearer {os.environ['TALO_API_KEY']}"},
    json={
        "function": "text.standard",
        "operation": "crm.resumen_llamada",
        "input": transcripcion,
    },
    timeout=120,
)
if res.status_code != 200:
    error = res.json()["error"]  # code, message, request_id, retryable
    raise RuntimeError(f"TALO AI {error['code']}: {error['message']} ({error['request_id']})")

texto = "".join(p["text"] for p in res.json()["output"] if p["type"] == "text")

curl -sS https://ai.test.talo.systems/v1/functions -H "Authorization: Bearer $TALO_API_KEY"

{
  "catalog_version": "2026-10-24.3",
  "functions": [
    {
      "name": "text.standard",
      "kind": "text",
      "description": "Procesamiento de texto estándar: resúmenes, clasificación, extracción y redacción corta.",
      "capabilities": ["text.generate"],
      "input_modalities": ["text"],
      "output_modalities": ["text"],
      "limits": { "timeout_seconds": 90, "max_output_tokens": 4096, "default_max_output_tokens": 1024 },
      "status": "available",
      "default": true
    },
    {
      "name": "audio.music",
      "kind": "audio",
      "description": "Generación de música a partir de una descripción.",
      "capabilities": ["music.generate"],
      "input_modalities": ["text"],
      "output_modalities": ["audio"],
      "limits": { "timeout_seconds": 300, "max_prompt_chars": 2000, "max_duration_seconds": 300, "default_duration_seconds": 30 },
      "status": "available"
    }
  ]
}

{
  "function": "text.advanced",
  "operation": "legal.revision_contrato",
  "messages": [
    { "role": "system", "content": [{ "type": "text", "text": "Eres un asistente legal. Responde en español y en viñetas." }] },
    { "role": "user", "content": [{ "type": "text", "text": "Revisa esta cláusula: …" }] }
  ],
  "options": { "max_output_tokens": 800 }
}

event: response.started
data: {"type":"response.started","request_id":"req_…","seq":0,"function":"text.standard"}

event: output.delta
data: {"type":"output.delta","request_id":"req_…","seq":1,"text":"La app "}

event: output.delta
data: {"type":"output.delta","request_id":"req_…","seq":2,"text":"se cierra…"}

event: usage.final
data: {"type":"usage.final","request_id":"req_…","seq":3,"usage":{…},"cost":{…}}

event: response.completed
data: {"type":"response.completed","request_id":"req_…","seq":4,"provider":"anthropic","resolved_model":"…","finish_reason":"stop","duration_ms":2310,"warnings":[]}

const res = await fetch("https://ai.test.talo.systems/v1/generate", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TALO_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ function: "text.standard", operation: "chat.respuesta", input: "Hola", stream: true }),
});
if (!res.ok) throw new Error(JSON.stringify(await res.json())); // error previo al stream

const decoder = new TextDecoder();
let buffer = "";
for await (const chunk of res.body) {
  buffer += decoder.decode(chunk, { stream: true });
  let sep;
  while ((sep = buffer.indexOf("\n\n")) >= 0) {
    const raw = buffer.slice(0, sep); buffer = buffer.slice(sep + 2);
    const event = /^event: (.*)$/m.exec(raw)?.[1];
    const data = /^data: (.*)$/m.exec(raw)?.[1];
    if (!event || !data) continue; // keepalive
    const payload = JSON.parse(data);
    if (event === "output.delta") process.stdout.write(payload.text);
    if (event === "response.failed") throw new Error(payload.error.message);
  }
}

curl -sS https://ai.test.talo.systems/v1/generate \
  -H "Authorization: Bearer $TALO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "function": "text.vision",
    "operation": "medidores.lectura",
    "messages": [
      { "role": "system", "content": [{ "type": "text",
        "text": "Extrae todos los números visibles en la imagen, en el orden en que aparecen. Usa punto decimal. Si no hay números, devuelve una lista vacía." }] },
      { "role": "user", "content": [
        { "type": "image", "url": "https://cdn.tuempresa.com/fotos/medidor-123.jpg" },
        { "type": "text", "text": "Es la foto de un medidor de agua; la lectura principal está en el visor negro." }
      ] }
    ],
    "options": {
      "response_format": {
        "type": "json_schema",
        "schema": {
          "type": "object",
          "required": ["numeros", "lectura_principal"],
          "properties": {
            "numeros": { "type": "array", "items": { "type": "number" } },
            "lectura_principal": { "type": ["number", "null"], "description": "Número del visor principal; null si no se ve" }
          }
        }
      }
    }
  }'

{
  "request_id": "req_01JC9A2B3C4D5E6F7G8H9J0K1M",
  "function": "text.vision",
  "provider": "gemini",
  "resolved_model": "gemini/gemini-2.5-flash-lite",
  "output": [{ "type": "text", "text": "{\"numeros\":[2024,1532.75,3],\"lectura_principal\":1532.75}" }],
  "output_json": { "numeros": [2024, 1532.75, 3], "lectura_principal": 1532.75 },
  "finish_reason": "stop",
  "usage": { "input_tokens": 1412, "output_tokens": 21, "source": "provider" },
  "cost": { "amount_micros": 150, "currency": "USD", "billing_status": "confirmed", "price_version": "gemini-2026-10-23" },
  "duration_ms": 1830,
  "warnings": []
}

$res = Http::withToken(env('TALO_API_KEY'))
    ->timeout(90)
    ->post(env('TALO_AI_URL') . '/v1/generate', [
        'function'  => 'text.vision',
        'operation' => 'medidores.lectura',
        'messages'  => [
            ['role' => 'system', 'content' => [['type' => 'text', 'text' => 'Extrae todos los números visibles. Usa punto decimal.']]],
            ['role' => 'user', 'content' => [
                ['type' => 'image', 'url' => $urlImagen],
                ['type' => 'text', 'text' => 'Foto de un medidor de agua.'],
            ]],
        ],
        'options' => ['response_format' => [
            'type'   => 'json_schema',
            'schema' => [
                'type'       => 'object',
                'required'   => ['numeros'],
                'properties' => ['numeros' => ['type' => 'array', 'items' => ['type' => 'number']]],
            ],
        ]],
    ]);

if ($res->failed()) {
    $error = $res->json('error');
    throw new RuntimeException("TALO AI {$error['code']}: {$error['message']} ({$error['request_id']})");
}

$numeros = $res->json('output_json.numeros');

res = requests.post(
    f"{os.environ['TALO_AI_URL']}/v1/generate",
    headers={"Authorization": f"Bearer {os.environ['TALO_API_KEY']}"},
    json={
        "function": "text.vision",
        "operation": "medidores.lectura",
        "messages": [
            {"role": "system", "content": [{"type": "text", "text": "Extrae todos los números visibles. Usa punto decimal."}]},
            {"role": "user", "content": [
                {"type": "image", "url": url_imagen},
                {"type": "text", "text": "Foto de un medidor de agua."},
            ]},
        ],
        "options": {"response_format": {"type": "json_schema", "schema": {
            "type": "object",
            "required": ["numeros"],
            "properties": {"numeros": {"type": "array", "items": {"type": "number"}}},
        }}},
    },
    timeout=90,
)
if res.status_code != 200:
    error = res.json()["error"]
    raise RuntimeError(f"TALO AI {error['code']}: {error['message']} ({error['request_id']})")

numeros = res.json()["output_json"]["numeros"]

curl -sS https://ai.test.talo.systems/v1/audio/generate \
  -H "Authorization: Bearer $TALO_API_KEY" -H "Content-Type: application/json" \
  -D cabeceras.txt -o intro.mp3 \
  -d '{"function":"audio.music","operation":"video.intro","prompt":"Intro lofi relajada con piano","duration_seconds":30,"instrumental":true}'

curl -sS https://ai.test.talo.systems/v1/limits -H "Authorization: Bearer $TALO_API_KEY"

{
  "app_id": "acme",
  "currency": "USD",
  "scopes": [{
    "scope": "app:acme", "period": "2026-10",
    "monthly_budget_micros": 50000000, "spent_micros": 1234567, "reserved_micros": 2000, "remaining_micros": 48763433,
    "requests_per_minute": 60, "concurrent_requests": 5, "max_output_tokens": 4096
  }]
}

curl -sS "https://ai.test.talo.systems/v1/usage/summary?from=2026-10-01T00:00:00Z&to=2026-11-01T00:00:00Z&group_by=operation" \
  -H "Authorization: Bearer $TALO_API_KEY"

{
  "error": {
    "code": "budget_exceeded",
    "message": "monthly budget exhausted for scope application",
    "request_id": "req_01JC8Z4R6M2V8K3N5P7Q9S1T3W",
    "retryable": false,
    "source": "gateway"
  }
}

Idempotency-Key: pedido-48213-resumen