AI Gateway for Production

One API.
Every AI Model.

Failover, rate limiting, webhooks, websockets, and structured data. Everything you need.

$ curl https://api.modelriver.com/v1/ai/async \
  -H "Authorization: Bearer YOUR_MR_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Explain AI"}],
    "workflow": "book_review"
  }'

const response = await fetch('https://api.modelriver.com/v1/ai/async', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_MR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{ role: 'user', content: 'Explain AI' }],
    workflow: 'book_review'
  })
});

import requests

response = requests.post(
    'https://api.modelriver.com/v1/ai/async',
    headers={
        'Authorization': 'Bearer YOUR_MR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'messages': [{'role': 'user', 'content': 'Explain AI'}],
        'workflow': 'book_review'
    }
)

$ch = curl_init('https://api.modelriver.com/v1/ai/async');

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_MR_API_KEY',
    'Content-Type: application/json'
]);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'messages' => [['role' => 'user', 'content' => 'Explain AI']],
    'workflow' => 'book_review'
]));

$response = curl_exec($ch);

require 'net/http'
require 'json'

uri = URI('https://api.modelriver.com/v1/ai/async')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_MR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
  messages: [{ role: 'user', content: 'Explain AI' }],
  workflow: 'book_review'
}.to_json

response = http.request(request)

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.modelriver.com/v1/ai/async"))
    .header("Authorization", "Bearer YOUR_MR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(
        "{\"messages\":[{\"role\":\"user\",\"content\":\"Explain AI\"}],\"workflow\":\"book_review\"}"
    ))
    .build();

HttpResponse<String> response = client.send(request,
    HttpResponse.BodyHandlers.ofString());

HTTPoison.post(
  "https://api.modelriver.com/v1/ai/async",
  Jason.encode!(%{
    messages: [%{
      role: "user",
      content: "Explain AI"
    }],
    workflow: "book_review"
  }),
  [
    {"Authorization", "Bearer YOUR_MR_API_KEY"},
    {"Content-Type", "application/json"}
  ]
)

payload := strings.NewReader(`{
  "messages": [{"role": "user", "content": "Explain AI"}],
  "workflow": "book_review"
}`)

req, _ := http.NewRequest("POST",
    "https://api.modelriver.com/v1/ai/async", payload)

req.Header.Add("Authorization", "Bearer YOUR_MR_API_KEY")
req.Header.Add("Content-Type", "application/json")

client := &http.Client{}
response, _ := client.Do(req)

Everything you need

Production-grade features built in

Auto Failover

Automatic provider switching when rate limits or errors occur. Zero downtime.

Rate Limiting

Per-user, per-IP, and per-project rate limiting. Protect your API from abuse.

Streaming

WebSocket live updates for real-time responses. Instant feedback as content generates.

Webhooks

Background jobs with automatic retry. Process AI requests asynchronously.

Structured Data

JSON schema validation for consistent outputs. Define once, enforce everywhere.

Analytics

Real-time dashboards with request logs, token usage, and performance metrics.

Integrate in seconds

One request. Infinite possibilities.

REQUEST

{
  "messages": [
    {
      "role": "user",
      "content": "Explain AI"
    }
  ],
  "workflow": "book_review",
  "task_id": "task_789",
  "user_id": "user_456"
}

IN PROGRESS

{
  "message": "success",
  "status": "IN_PROGRESS",
  "channel_id": "abc-123",
  "customer_data": {
    "task_id": "task_789",
    "user_id": "user_456"
  },
  "ws_token": "token-xyz",
  "websocket_url": "wss://..."
}

SUCCESS

{
  "message": "success",
  "status": "SUCCESS",
  "channel_id": "abc-123",
  "customer_data": {
    "task_id": "task_789",
    "user_id": "user_456"
  },
  "data": {
    "choices": [...]
  },
  "meta": {
    "workflow": "book_review",
    "duration_ms": 1234
  }
}

Start building today

1,000 free requests (total). No credit card required.

Get Early Access

One API. Every AI Model.