Choose execution providers for an API request

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/chat/completions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "provider": {
    "only": [
      "shareai"
    ],
    "allow_fallbacks": false
  },
  "model": "openai/gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "Explain model routing in one sentence."
    }
  ]
}'

Python

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'only': ['shareai'], 'allow_fallbacks': False}, 'model': 'openai/gpt-5.4', 'messages': [{'role': 'user', 'content': 'Explain model routing in one sentence.'}]}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
    print(json.load(response))

TypeScript

const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "provider": {
    "only": [
      "shareai"
    ],
    "allow_fallbacks": false
  },
  "model": "openai/gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "Explain model routing in one sentence."
    }
  ]
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

JSON

{
  "provider": {
    "order": [
      "PROVIDER_A",
      "PROVIDER_B"
    ],
    "allow_fallbacks": false,
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  }
}