Talo API documentation.
One key, one request format.

#!/usr/bin/env bash
set -euo pipefail
: "${TALO_API_KEY:?Set your Talo API key}"
: "${TALO_MODEL:?Choose an ID from GET /models}"
[[ "$TALO_MODEL" =~ ^[a-z][a-z0-9-]{1,59}$ ]] || exit 1
base="${TALO_BASE_URL:-https://taloventra.com/api/v1}"
request_id="$(cat /proc/sys/kernel/random/uuid)"
curl --fail-with-body --silent --show-error --max-time 150 \
  "$base/chat/completions" \
  -H "Authorization: Bearer $TALO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $request_id" \
  --data "{\"model\":\"$TALO_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Say hello\"}],\"max_tokens\":64}"

<?php
$key = getenv('TALO_API_KEY');
$model = getenv('TALO_MODEL');
if (!$key || !$model) throw new RuntimeException('Set TALO_API_KEY and TALO_MODEL');
$base = rtrim(getenv('TALO_BASE_URL') ?: 'https://taloventra.com/api/v1', '/');
$requestId = bin2hex(random_bytes(16));
$curl = curl_init($base . '/chat/completions');
curl_setopt_array($curl, [
    CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 150,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $key,
        'Content-Type: application/json', 'Idempotency-Key: ' . $requestId],
    CURLOPT_POSTFIELDS => json_encode(['model' => $model,
        'messages' => [['role' => 'user', 'content' => 'Say hello']],
        'max_tokens' => 64], JSON_THROW_ON_ERROR),
]);
$raw = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
$error = curl_error($curl);
curl_close($curl);
if ($raw === false) throw new RuntimeException('Network error; check Usage before retrying: ' . $error);
$result = json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
if ($status !== 200) throw new RuntimeException('HTTP ' . $status . ': ' . ($result['error']['code'] ?? 'request_failed'));
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
// Assistant text: $result['choices'][0]['message']['content']

import { randomUUID } from 'node:crypto';
const { TALO_API_KEY: key, TALO_MODEL: model } = process.env;
if (!key || !model) throw new Error('Set TALO_API_KEY and TALO_MODEL');
const base = (process.env.TALO_BASE_URL || 'https://taloventra.com/api/v1').replace(/\/$/, '');
const response = await fetch(`${base}/chat/completions`, {
  method: 'POST', signal: AbortSignal.timeout(150000),
  headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID() },
  body: JSON.stringify({ model, messages: [{ role: 'user', content: 'Say hello' }], max_tokens: 64 })
});
const result = await response.json();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${result.error?.code || 'request_failed'}`);
console.log(JSON.stringify(result, null, 2));
// Assistant text: result.choices[0].message.content
// On timeout/network failure, check Usage before intentionally making another request.

import java.net.URI;
import java.net.http.*;
import java.time.Duration;
import java.util.UUID;

public class TaloExample {
    public static void main(String[] args) throws Exception {
        String key = System.getenv("TALO_API_KEY");
        String model = System.getenv("TALO_MODEL");
        if (key == null || model == null || !model.matches("[a-z][a-z0-9-]{1,59}"))
            throw new IllegalArgumentException("Set TALO_API_KEY and a valid TALO_MODEL");
        String base = System.getenv().getOrDefault("TALO_BASE_URL", "https://taloventra.com/api/v1");
        String body = "{\"model\":\"" + model + "\",\"messages\":[{\"role\":\"user\",\"content\":\"Say hello\"}],\"max_tokens\":64}";
        HttpRequest request = HttpRequest.newBuilder(URI.create(base.replaceAll("/$", "") + "/chat/completions"))
            .timeout(Duration.ofSeconds(150))
            .header("Authorization", "Bearer " + key)
            .header("Content-Type", "application/json")
            .header("Idempotency-Key", UUID.randomUUID().toString())
            .POST(HttpRequest.BodyPublishers.ofString(body)).build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        if (response.statusCode() != 200)
            throw new IllegalStateException("HTTP " + response.statusCode() + ": " + response.body());
        System.out.println(response.body());
        // Parse JSON with your application's JSON library; read choices[0].message.content.
        // For dynamic messages use that library's JSON encoder, not string concatenation.
    }
}