Rynler API reference

The current text inference API uses an OpenAI-compatible chat completion request.

Base URL

https://api.rynler.com/v1

Authentication

Include Authorization: Bearer RYNLER_API_KEY. The key needs inference scope. See authentication details.

List models

GET /v1/models returns the models currently available to your key. The public catalogue shows model details and prices.

Create a chat completion

POST /v1/chat/completions accepts a model ID and text messages with system, user, or assistant roles. Optional fields include temperature, max_tokens, and streaming. Supply a fresh Idempotency-Key header for each request.

import os
import uuid
from openai import OpenAI

client = OpenAI(
    base_url="https://api.rynler.com/v1",
    api_key=os.environ["RYNLER_API_KEY"]
)

response = client.chat.completions.create(
    model="xiaomi/mimo-v2.6-flash",
    messages=[{"role": "user", "content": "Hello, world."}],
    max_tokens=1024,
    extra_headers={"Idempotency-Key": str(uuid.uuid4())}
)
print(response.choices[0].message.content)

Streaming emits a validated result over server-sent events after upstream completion. Native token-by-token streaming, tool calls, and the Responses API are not supported.

Image input availability

Image input requires a specifically enabled vision model and supported image parts in user messages. Check GET /v1/vision-capabilities before use. A model name alone does not establish that vision is available.

Errors

Application errors return an error object with a code, message, and request ID. A token limit error means the input or requested output is too large. A rate limit error means you should reduce concurrency. An unavailable model or service should be checked against service status. A gateway failure can return a non-JSON response; retain the request details and check its outcome before submitting new work.

Read the quickstart, request limits, and pricing before integrating.