Siray AI API Docs | OpenAI Compatible API

Get model pricing

curl --request GET \
  --url https://api.siray.ai/v1/models/pricing/{model_name} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.siray.ai/v1/models/pricing/{model_name}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.siray.ai/v1/models/pricing/{model_name}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.siray.ai/v1/models/pricing/{model_name}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.siray.ai/v1/models/pricing/{model_name}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "request_uuid": "f1c2d3e4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "code": 200,
  "message": "OK",
  "data": {
    "id": "openai/gpt-5",
    "name": "GPT-5",
    "billing_type": "token",
    "discount": 0.2,
    "free": false,
    "input_price": {
      "price": "0.312",
      "original_price": "0.390",
      "unit": "1M tokens",
      "unit_size": 1000000
    },
    "output_price": {
      "price": "1.250",
      "original_price": "1.562",
      "unit": "1M tokens",
      "unit_size": 1000000
    },
    "catalog": {
      "dimensions": [
        {
          "key": "input",
          "name": "Input"
        },
        {
          "key": "output",
          "name": "Output"
        }
      ],
      "pricing_options": [
        {
          "parameters": [
            {
              "key": "input",
              "value": "$0.312 / 1M"
            },
            {
              "key": "output",
              "value": "$1.250 / 1M"
            }
          ]
        }
      ],
      "pricing_description": "",
      "token_pricing_rules": [
        {
          "rule_name": "input",
          "direction": "input",
          "tiered_mode": "",
          "min_tokens": 0,
          "max_tokens": 0,
          "tier_by": "",
          "price": "0.312",
          "unit_size": 1000000,
          "display_only": false
        },
        {
          "rule_name": "output",
          "direction": "output",
          "tiered_mode": "",
          "min_tokens": 0,
          "max_tokens": 0,
          "tier_by": "",
          "price": "1.250",
          "unit_size": 1000000,
          "display_only": false
        }
      ]
    }
  }
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

GET

models

pricing

{model_name}

Get model pricing

curl --request GET \
  --url https://api.siray.ai/v1/models/pricing/{model_name} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.siray.ai/v1/models/pricing/{model_name}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.siray.ai/v1/models/pricing/{model_name}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.siray.ai/v1/models/pricing/{model_name}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.siray.ai/v1/models/pricing/{model_name}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "request_uuid": "f1c2d3e4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "code": 200,
  "message": "OK",
  "data": {
    "id": "openai/gpt-5",
    "name": "GPT-5",
    "billing_type": "token",
    "discount": 0.2,
    "free": false,
    "input_price": {
      "price": "0.312",
      "original_price": "0.390",
      "unit": "1M tokens",
      "unit_size": 1000000
    },
    "output_price": {
      "price": "1.250",
      "original_price": "1.562",
      "unit": "1M tokens",
      "unit_size": 1000000
    },
    "catalog": {
      "dimensions": [
        {
          "key": "input",
          "name": "Input"
        },
        {
          "key": "output",
          "name": "Output"
        }
      ],
      "pricing_options": [
        {
          "parameters": [
            {
              "key": "input",
              "value": "$0.312 / 1M"
            },
            {
              "key": "output",
              "value": "$1.250 / 1M"
            }
          ]
        }
      ],
      "pricing_description": "",
      "token_pricing_rules": [
        {
          "rule_name": "input",
          "direction": "input",
          "tiered_mode": "",
          "min_tokens": 0,
          "max_tokens": 0,
          "tier_by": "",
          "price": "0.312",
          "unit_size": 1000000,
          "display_only": false
        },
        {
          "rule_name": "output",
          "direction": "output",
          "tiered_mode": "",
          "min_tokens": 0,
          "max_tokens": 0,
          "tier_by": "",
          "price": "1.250",
          "unit_size": 1000000,
          "display_only": false
        }
      ]
    }
  }
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

{
  "request_uuid": "<string>",
  "code": 401,
  "message": "missing authorization header"
}

Overview

Use this endpoint to retrieve the price of one model before sending a generation request. The response contains a headline price summary and the full pricing catalog. For token models, the headline price is quoted per 1 million tokens. For image, video, and 3D models, the catalog contains the exact price for each supported resolution, duration, size, or other parameter combination.

Call GET https://api.siray.ai/v1/models/pricing to list the headline price of every public model, then use this endpoint for the full catalog of a single model.

Endpoint

GET https://api.siray.ai/v1/models/pricing/{model_name}

Headers

Authorization: Bearer <SIRAY_API_TOKEN>

Path parameters

Name	Description
`model_name`	Model name, such as `openai/gpt-5` or `kling/v2.6-pro`.

Response structure

The response uses the standard Siray response envelope. data contains the headline summary and the catalog used to calculate the final request price.

{
  "request_uuid": "f1c2d3e4-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "code": 200,
  "message": "OK",
  "data": {
    "id": "openai/gpt-5",
    "name": "GPT-5",
    "billing_type": "token",
    "discount": 0.2,
    "free": false,
    "input_price": {
      "price": "0.312",
      "original_price": "0.390",
      "unit": "1M tokens",
      "unit_size": 1000000
    },
    "output_price": {
      "price": "1.250",
      "original_price": "1.562",
      "unit": "1M tokens",
      "unit_size": 1000000
    },
    "catalog": {
      "dimensions": [
        { "key": "input", "name": "Input" },
        { "key": "output", "name": "Output" }
      ],
      "pricing_options": [
        {
          "parameters": [
            { "key": "input", "value": "$0.312 / 1M" },
            { "key": "output", "value": "$1.250 / 1M" }
          ]
        }
      ],
      "pricing_description": "",
      "token_pricing_rules": [
        {
          "rule_name": "input",
          "direction": "input",
          "tiered_mode": "",
          "min_tokens": 0,
          "max_tokens": 0,
          "tier_by": "",
          "price": "0.312",
          "unit_size": 1000000,
          "display_only": false
        },
        {
          "rule_name": "output",
          "direction": "output",
          "tiered_mode": "",
          "min_tokens": 0,
          "max_tokens": 0,
          "tier_by": "",
          "price": "1.250",
          "unit_size": 1000000,
          "display_only": false
        }
      ]
    }
  }
}

Fields

request_uuid: Identifier of this API call, useful for support and log correlation.
code / message: Service-level indicators for the request outcome (200 / OK on success).
data.id: Model name used when calling the generation endpoint.
data.name: Human-readable model name.
data.billing_type: Billing model. One of token, image, video, or 3d.
data.discount: Effective discount applied to this account, as a decimal fraction. 0.2 means 20% off; 0 means no discount.
data.free: Whether the model is free for this account. When catalog_only is true, this is false because the summary cannot determine the exact price; use catalog instead.
data.catalog_only: Present and true when the exact price depends on request parameters or token usage; omitted when false. In that case output_price is omitted and you must read data.catalog.
data.input_price: Token input price summary. Only returned for token models.
data.output_price: Output price summary. Returned for token models and for media models without parameter-based rules. Omitted when catalog_only is true.
data.catalog: Full pricing catalog. Always present for this endpoint.
data.input_price / data.output_price fields:
- price: Price this account pays, as a display string. Parse it as a decimal instead of assuming a JSON number.
- original_price: Price before the effective discount (model and account discounts), as a display string.
- unit: 1M tokens for token prices; image, second, or generation for media prices; unit for an unrecognized billing type.
- unit_size: Number of tokens represented by one unit. Present for token prices.

All amounts are in USD.

Catalog fields

catalog.dimensions: Parameters that affect the price, such as resolution, duration, or prompt_size. May be empty when the price does not depend on parameters.
catalog.pricing_options: One entry per supported parameter combination. May be empty when the model has no catalog options. Each entry contains:
- parameters: Parameter key/value pairs for the combination. For token matrices, the price may appear here as a display string such as $0.090 / 1M.
- cost: Price for the combination, in USD. May be a single value (0.250) or a range (0.200~0.310). May include an add-on clause, for example 0.036 + $0.002 each input image. Omitted for token matrices where prices appear in parameters.
- original_cost: Price before the effective discount. Uses the same single-value, range, and add-on formats as cost; omitted together with cost for token matrices.
catalog.pricing_description: Human-readable explanation of the billing formula and any add-ons. May be empty when there is nothing extra to explain.
catalog.token_pricing_rules: Optional. Token-level pricing rules. Omitted when the model has no token pricing rules.

Token pricing rule fields

rule_name: Name of the pricing rule.
token_type: Token type. Values include text, audio, cached, cache_write, cache_write_5m, cache_write_1h, image, and reasoning. Empty means all token types for the direction.
direction: input or output.
tiered_mode: flat or graduated; empty means a fixed (non-tiered) price.
min_tokens: Inclusive lower bound of the tier.
max_tokens: Exclusive upper bound of the tier. 0 means no upper bound.
tier_by: input means the tier is selected by total input volume. Empty means the tier is selected by the rule’s own token quantity.
price: USD price per unit_size tokens. May be a single value (0.312) or a range (0.200~0.310).
unit_size: Number of tokens represented by one price unit, for example 1000000.
display_only: true means the rule is only for display and does not participate in billing.
match_conditions: Optional list of conditions that must match for the rule to apply:
- param: Request parameter name.
- value: Expected value.
- operator: Match operator: empty for equality, not_empty for a non-empty parameter, or count to match an array length.
- param_alias: Display alias for the parameter.
- value_alias: Display alias for the value.

`catalog_only` models

For image, video, or 3D models with parameter-based pricing rules, and for 3D models billed by token rules, the data object looks like:

{
  "id": "kling/v2.6-pro",
  "name": "Kling 2.6 Pro",
  "billing_type": "video",
  "discount": 0,
  "free": false,
  "catalog_only": true,
  "catalog": {
    "dimensions": [
      { "key": "resolution", "name": "Resolution" },
      { "key": "duration", "name": "Duration" }
    ],
    "pricing_options": [
      {
        "parameters": [
          { "key": "resolution", "value": "720P" },
          { "key": "duration", "value": "5 seconds" }
        ],
        "cost": "0.250",
        "original_cost": "0.250"
      },
      {
        "parameters": [
          { "key": "resolution", "value": "1080P" },
          { "key": "duration", "value": "5 seconds" }
        ],
        "cost": "0.400",
        "original_cost": "0.400"
      }
    ],
    "pricing_description": "Billing formula: resolution price × video duration."
  }
}

In this case there is no single output_price. Choose the pricing_options entry that matches your request parameters.

Usage examples

Token model:

curl -X GET "https://api.siray.ai/v1/models/pricing/openai%2Fgpt-5" \
  -H "Authorization: Bearer ${SIRAY_API_TOKEN}"

Video model with parameter-based pricing:

curl -X GET "https://api.siray.ai/v1/models/pricing/kling%2Fv2.6-pro" \
  -H "Authorization: Bearer ${SIRAY_API_TOKEN}"

Errors

The endpoint returns the standard response envelope. Non-200 code values indicate failure and come with a message and no data.

HTTP status	`code`	Typical cause
400	400	`model_name` is empty.
401	401	Missing or malformed `Authorization` header; unknown API key.
403	403	API key is disabled or expired, or the account is forbidden.
404	404	Model does not exist or is not publicly visible.
500	500	Pricing data could not be loaded; retry later.

Authorizations

Authorization

string

header

required

API token passed as a Bearer token in the Authorization header.

Path Parameters

model_name

string

required

Model name, such as openai/gpt-5 or kling/v2.6-pro.

Response

Model price summary and pricing catalog

Standard response envelope for a single model price.

request_uuid

string

required

Identifier of this API call, useful for support and log correlation.

code

integer

required

Service-level status code (200 on success).

Example:

200

message

string

required

Additional information about the request result.

Example:

"OK"

data

object

required

Headline price summary and full pricing catalog for one model.

Show child attributes

API documentation

Model API Examples

Model APIs

Model Pricing API

Overview

Endpoint

Response structure

Fields

Catalog fields

Token pricing rule fields

`catalog_only` models

Usage examples

Errors

Authorizations

Path Parameters

Response

​Overview

​Endpoint

​Response structure

​Fields

​Catalog fields

​Token pricing rule fields

​catalog_only models

​Usage examples

​Errors

Authorizations

Path Parameters

Response

Overview

Endpoint

Response structure

Fields

Catalog fields

Token pricing rule fields

`catalog_only` models

Usage examples

Errors