模型价格接口

curl --request GET \
  --url https://api.apimart.ai/api/pricing/model

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apimart.ai/api/pricing/model",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.apimart.ai/api/pricing/model"

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

	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.apimart.ai/api/pricing/model")

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

request = Net::HTTP::Get.new(url)

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

GET

api

pricing

model

模型价格接口

curl --request GET \
  --url https://api.apimart.ai/api/pricing/model

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apimart.ai/api/pricing/model",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.apimart.ai/api/pricing/model"

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

	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.apimart.ai/api/pricing/model")

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

request = Net::HTTP::Get.new(url)

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

以 qwen3.8-max 为例说明；data.pricing 的结构对所有走 TokenPricingV2 的模型通用。

GET /api/pricing/model?model=qwen3.8-max

完整模型能力与计费口径见 qwen3.8-max 接入指南。

本接口无需鉴权，不必传 Authorization。

请求参数

string

必填

模型 ID，例如 qwen3.8-max。必填；不传会返回 400 Missing model parameter。

只读 `data.pricing`

响应里可能有多个价格相关块，前端只应读 data.pricing：

块	用途	前端
`data.pricing`	扁平、自描述的展示视图	✅ 只读这个
`data.token_price`	历史扁平副本	❌ 兼容保留，会漏字段
`data.token_pricing`	内部快照	❌ 含实现细节

token_price 可能缺少 explicit_cached_input 等字段，按它估价会偏高。新计费维度只会进入 pricing。示例对比：

{
  "token_price": {
    "input": 1.714286,
    "cached_input": 0.214286,
    "cache_write": 2.142857,
    "output": 5.142857
  },
  "pricing": {
    "rates": {
      "input": 1.714286,
      "cached_input": 0.214286,
      "cache_write": 2.142857,
      "explicit_cached_input": 0.142857,
      "output": 5.142857
    }
  }
}

`rates` 与 `effective_rates`

字段	含义
`rates`	划线价 / 原价
`effective_rates`	实付价（已乘折扣）
`discount_rate`	模型折扣（无折扣为 `1`）
`group_ratio`	分组倍率
`price_factor`	`discount_rate × group_ratio`，唯一乘数

{
  "discount_rate": 1,
  "group_ratio": 0.8,
  "price_factor": 0.8,
  "rates": { "input": 1.714286, "output": 5.142857 },
  "effective_rates": { "input": 1.3714288, "output": 4.1142856 }
}

展示价直接用 effective_rates，不要自己再乘。 需要同时显示划线价时再用 rates。

group 常为 default：价格页面向访客统一按 default 报价。用户真实扣费按其所属分组，可能低于展示价。

rates / effective_rates 的 unit 一般为 usd_per_million_tokens（每百万 token 美元价）。

工具价：`extras.tools` 只有原价

这是当前接口的不对称点：

	原价	实付
token	`rates`	`effective_rates`（后端已算好）
内置工具	`extras.tools[x].price`	无 effective 字段，前端自己 × `price_factor`

const listed = pricing.extras.tools.web_search.price; // 原价
const actual = listed * pricing.price_factor; // 展示 / 估算用这个

按 unit 换算，不要写死「每千次」：

`unit`	含义	费用
`usd_per_1000_queries`	每 1000 次调用	`price / 1000 × 次数`
`usd_per_page`	每页	`price × 页数`（不除 1000）

字段缺省的三态语义

情况	JSON	含义
有值	`"explicit_cached_input": 0.142857`	按该价收费
整键不出现	—	该维度不适用（不是 0、不是免费）
显式 `0`	`"price": 0`	确实免费，应显示「免费」

示例：

output_thinking 不出现 → 只有一个输出价，不要渲染成「思考免费」。qwen3.8-max 思考不可关，官方只公布一个输出价。
extras.google_web_search 不出现 → Vertex 专有字段；百炼类搜索在 extras.tools.web_search。
extras.tools 里某工具 price: 0 → 显式免费（如限时免费），如实展示。

是否多档：只看 `tier_count`

{
  "billing_type": "tiered_token",
  "tier_count": 1
}

判断	说明
`tier_count === 1`	不要渲染阶梯表；用 `rates` / `effective_rates`
`tier_count > 1`	有 `tiers[]`；`up_to_input_tokens` 为本档输入上界（含）；键不出现 = 不封顶（通常最后一档）

阶梯语义：按单次请求输入 token 总量选一档，整请求按该档单价结算（不累进）。tiers 内是原价，乘 price_factor 得实付。

billing_type === "tiered_token" 不能用来判断是否多档——单档模型也可能是这个值。只看 tier_count。

`limits`（与单价无关）

{
  "limits": {
    "max_input_tokens": 983616,
    "max_output_tokens": 131072,
    "supports_cache_read": true,
    "supports_cache_write": true
  }
}

supports_cache_read / supports_cache_write：是否支持缓存能力；为 false 时即使 rates 有缓存价也不应展示为可用。
max_output_tokens：请求未传 max_tokens 时的预扣上限参考，不是价格。

TypeScript 类型（可直接用）

type ToolItem = {
  unit: "usd_per_1000_queries" | "usd_per_page";
  price: number; // 原价，展示前 × price_factor
  precharge_queries?: number;
};

type Rates = {
  input?: number;
  cached_input?: number;
  explicit_cached_input?: number; // 缺省 ≈ 与 cached_input 同价
  cache_write?: number;
  cache_write_5m?: number;
  cache_write_1h?: number;
  output?: number;
  output_thinking?: number; // 缺省 = 仅一个输出价
  // pricing_mode === "image_modalities" 时另有 text_*/image_* 字段，勿与 standard 混读
  text_input?: number;
  cached_text_input?: number;
  image_input?: number;
  cached_image_input?: number;
  text_output?: number;
  image_output?: number;
};

type ModelPricing = {
  billing_type: string;
  source: "v1" | "v2";
  unit: "usd_per_million_tokens";
  pricing_mode: "standard" | "image_modalities";
  discount_rate: number;
  group: string;
  group_ratio: number;
  price_factor: number;
  resolved_from?: string;
  rates?: Rates;
  effective_rates?: Rates;
  tier_count: number;
  tiers?: (Rates & { up_to_input_tokens?: number })[];
  limits?: {
    max_input_tokens?: number;
    max_output_tokens?: number;
    supports_cache_read: boolean;
    supports_cache_write: boolean;
  };
  extras?: {
    tools?: Record<string, ToolItem>;
    google_web_search?: ToolItem;
  };
};

工具价渲染示例

const toolRows = Object.entries(pricing.extras?.tools ?? {}).map(
  ([tool, item]) => ({
    tool,
    actual: item.price * pricing.price_factor,
    suffix: item.unit === "usd_per_page" ? "/ 页" : "/ 千次调用",
    free: item.price === 0,
  }),
);

常见错法

错误	正确
读 `token_price`	读 `pricing.rates` / `pricing.effective_rates`
自己 `rates × group_ratio`	直接用 `effective_rates`
工具价直接展示 `extras.tools[x].price`	× `price_factor` 后再展示
工具后缀写死「每千次」	按 `item.unit` 判断
缺省字段当 0 / 免费	缺省 = 不适用；只有显式 `0` 才是免费
用 `billing_type` 判多档	用 `tier_count > 1`
单档去读 `tiers`	单档用 `rates`
`pricing_mode` 混读字段	`standard` 与 `image_modalities` 字段互斥

请求示例

curl --request GET \
  --url 'https://api.apimart.ai/api/pricing/model?model=qwen3.8-max' \
  --header 'Accept: application/json'

import requests

url = "https://api.apimart.ai/api/pricing/model"
params = {"model": "qwen3.8-max"}
headers = {"Accept": "application/json"}
print(requests.get(url, params=params, headers=headers).json())

概览

模型

文字系列

图像系列

视频系列

音频系列

审核系列

上传管理

任务管理

账户管理

模型价格接口

请求参数

只读 `data.pricing`

`rates` 与 `effective_rates`

工具价：`extras.tools` 只有原价

字段缺省的三态语义

是否多档：只看 `tier_count`

`limits`（与单价无关）

TypeScript 类型（可直接用）

工具价渲染示例

常见错法

请求示例

​请求参数

​只读 data.pricing

​rates 与 effective_rates

​工具价：extras.tools 只有原价

​字段缺省的三态语义

​是否多档：只看 tier_count

​limits（与单价无关）

​TypeScript 类型（可直接用）

​工具价渲染示例

​常见错法

​请求示例

请求参数

只读 `data.pricing`

`rates` 与 `effective_rates`

工具价：`extras.tools` 只有原价

字段缺省的三态语义

是否多档：只看 `tier_count`

`limits`（与单价无关）

TypeScript 类型（可直接用）

工具价渲染示例

常见错法

请求示例