Copy. Paste. Call.

curl https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [
      {"role": "user", "content": "Explain HTTP caching in two sentences."}
    ]
  }'

base https://kitsune.cv/v1 · Authorization: Bearer kts-…

curl -N https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [{"role": "user", "content": "Count to five."}],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

Set stream_options.include_usage to receive a final usage chunk.

curl https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [{"role": "user", "content": "Design a retry strategy for a payment API."}],
    "reasoning_effort": "high"
  }'

Thinking is billed as completion tokens reported for the turn.

curl https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [{"role": "user", "content": "What is the time in Tashkent?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_time",
        "description": "Return the current time for a city.",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string", "description": "City name"}},
          "required": ["city"],
          "additionalProperties": false
        }
      }
    }],
    "tool_choice": "auto"
  }'

Use strict JSON Schema; the model returns arguments as a JSON string.

curl https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [{"role": "user", "content": "Check the time in Tashkent and Warsaw."}],
    "tools": [/* get_time, get_weather */],
    "tool_choice": "auto",
    "parallel_tool_calls": true
  }'

curl https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "What is in this image?"},
        {"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}}
      ]
    }]
  }'

const API_KEY = process.env.KITSUNE_KEY;
const BASE = 'https://kitsune.cv/v1';

async function api(path, body) {
  const res = await fetch(BASE + path, {
    method: body ? 'POST' : 'GET',
    headers: {
      authorization: 'Bearer ' + API_KEY,
      'content-type': 'application/json'
    },
    body: body ? JSON.stringify(body) : undefined
  });
  if (!res.ok) throw new Error(await res.text());
  return res.json();
}

const completion = await api('/chat/completions', {
  model: 'minimax-m3.1-flash',
  messages: [{ role: 'user', content: 'Extract the invoice as JSON.' }],
  response_format: {
    type: 'json_schema',
    json_schema: {
      name: 'invoice',
      strict: true,
      schema: {
        type: 'object',
        properties: {
          vendor: { type: 'string' },
          total: { type: 'number' },
          currency: { type: 'string' }
        },
        required: ['vendor', 'total', 'currency'],
        additionalProperties: false
      }
    }
  }
});

const invoice = JSON.parse(completion.choices[0].message.content);

curl https://kitsune.cv/v1/chat/completions \
  -H "Authorization: Bearer $KITSUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m3.1-flash",
    "messages": [{"role": "user", "content": "Write a product name."}],
    "temperature": 0.9,
    "top_p": 0.95,
    "max_tokens": 64,
    "stop": ["\n\n"],
    "presence_penalty": 0.2,
    "frequency_penalty": 0.1,
    "seed": 42,
    "n": 1
  }'

Unknown/extra fields are forwarded unchanged. Support varies by model.

curl https://kitsune.cv/v1/models \
  -H "Authorization: Bearer $KITSUNE_KEY"

curl https://kitsune.cv/v1/models/minimax-m3.1-flash \
  -H "Authorization: Bearer $KITSUNE_KEY"

# public catalog, no key:
curl https://kitsune.cv/v1/catalog

curl https://kitsune.cv/v1/models \
  -H "Authorization: Bearer $KITSUNE_KEY"

All examples target the same OpenAI-compatible schema over plain HTTPS.