Get Models

curl --request GET \
  --url https://api.tikway.ai/v1/models \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.tikway.ai/v1/models', 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.tikway.ai/v1/models",
  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.tikway.ai/v1/models"

	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.tikway.ai/v1/models")

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

{
  "object": "list",
  "data": [
    {
      "id": "happyhorse-1.0",
      "name": "HappyHorse 1.0",
      "aliases": [
        "happyhorse-1.0",
        "happyhorse-1.0-20260624"
      ],
      "architecture": {
        "input_modalities": [
          "text",
          "image",
          "video"
        ],
        "output_modalities": [
          "video"
        ]
      },
      "capabilities": {
        "endpoints": [
          "/v1/videos"
        ],
        "parameters": {
          "/v1/videos": [],
          "common": [
            "seed",
            "model",
            "prompt",
            "duration",
            "extra_body",
            "resolution",
            "aspect_ratio",
            "callback_url",
            "frame_images",
            "input_references"
          ]
        },
        "reasoning_efforts": []
      },
      "context_length": null,
      "object": "model",
      "created": 0,
      "owned_by": "HappyHorse",
      "video_attributes": {
        "modes": [],
        "resolutions": [],
        "default_resolution": null,
        "min_duration_seconds": null,
        "max_duration_seconds": null,
        "supports_audio": null,
        "aspect_ratios": []
      }
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

OpenAI 协议

Get Models

获取当前网关具有可调用端点的模型目录。默认返回全部类型，可用 type 按 text、image、video、music、embedding 筛选；多个类型用逗号分隔，或重复传 type，结果取并集。

响应兼容 OpenAI object=list/data 结构，并提供 aliases、architecture、capabilities 和视频模型的 video_attributes。capabilities.parameters.common 为所有可调用端点共有的参数，端点键下仅列该端点的额外参数；端点完整参数集为 common 与端点数组的并集。

本条目描述普通 OpenAI 格式。携带 anthropic-version 请求头会切换为 Anthropic 模型列表格式，应使用对应协议客户端解析。

GET

https://api.tikway.ai

models

Get Models

curl --request GET \
  --url https://api.tikway.ai/v1/models \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.tikway.ai/v1/models', 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.tikway.ai/v1/models",
  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.tikway.ai/v1/models"

	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.tikway.ai/v1/models")

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

{
  "object": "list",
  "data": [
    {
      "id": "happyhorse-1.0",
      "name": "HappyHorse 1.0",
      "aliases": [
        "happyhorse-1.0",
        "happyhorse-1.0-20260624"
      ],
      "architecture": {
        "input_modalities": [
          "text",
          "image",
          "video"
        ],
        "output_modalities": [
          "video"
        ]
      },
      "capabilities": {
        "endpoints": [
          "/v1/videos"
        ],
        "parameters": {
          "/v1/videos": [],
          "common": [
            "seed",
            "model",
            "prompt",
            "duration",
            "extra_body",
            "resolution",
            "aspect_ratio",
            "callback_url",
            "frame_images",
            "input_references"
          ]
        },
        "reasoning_efforts": []
      },
      "context_length": null,
      "object": "model",
      "created": 0,
      "owned_by": "HappyHorse",
      "video_attributes": {
        "modes": [],
        "resolutions": [],
        "default_resolution": null,
        "min_duration_seconds": null,
        "max_duration_seconds": null,
        "supports_audio": null,
        "aspect_ratios": []
      }
    }
  ]
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

x-provider-route

string

默认值:cost

上游速度cost、stable、fast

查询参数

type

string

按模型类型筛选，省略返回全部。支持 text/image/video/music/embedding，忽略大小写和周围空格。多个类型逗号分隔或重复 type，未知或空值返回 400。

Minimum string length: 1

示例:

"text"

"image"

"video"

"music"

"embedding"

"image,video"

响应

当前可调用模型目录；示例能力值仅用于展示结构，实际以返回值为准。

GET /v1/models 的 HTTP 200 响应。返回平台完整可调用模型目录；公共元数据来自平台配置。

object

string

必填

Allowed value: "list"

data

object[]

必填

Hide child attributes

data.id

string

必填

平台模型 ID。存在供应商命名空间时完整保留，例如 google/gemini-3.8-flash。

Minimum string length: 1

data.name

string

必填

模型显示名称。

data.aliases

string[]

必填

模型的可用别名，来自当前平台配置；未配置时返回空数组。

data.context_length

integer | null

必填

上下文 token 上限，未配置时为 null。

必填范围: x >= 0

data.architecture

object

必填

模型可接受和可输出的模态，按平台配置及实际可调用端点生成。

Hide child attributes

data.architecture.input_modalities

string[]

必填

data.architecture.output_modalities

string[]

必填

data.capabilities

object

必填

当前平台定义的端点、参数和推理档位。与其他协议格式中的这组字段一致。

Hide child attributes

data.capabilities.reasoning_efforts

string[]

必填

按实际端点参数配置汇总的推理档位；无可配置档位时返回空数组。

data.capabilities.endpoints

string[]

必填

模型当前实际可调用的 API 路径，来自平台路由配置。

Minimum array length: 1

data.capabilities.parameters

object

必填

common 为所有可调用端点共有的参数，各端点路径下只列额外参数。该端点的完整参数集为 common 与端点数组的并集；单端点模型的参数可全部位于 common。

Hide child attributes

data.capabilities.parameters.common

string[]

必填

data.capabilities.parameters.{key}

string[]

示例:

{
  "/v1/videos": [],
  "common": [
    "seed",
    "model",
    "prompt",
    "duration",
    "extra_body",
    "resolution",
    "aspect_ratio",
    "callback_url",
    "frame_images",
    "input_references"
  ]
}

data.object

string

必填

Allowed value: "model"

data.owned_by

string

必填

模型系列名称；未配置时使用模型 ID 的供应商命名空间。

data.created

integer

必填

模型创建时间，Unix 秒；未配置时当前返回 0。

必填范围: x >= 0

示例:

0

data.max_output_tokens

integer

配置时返回的最大输出 token 数；未配置时省略。

必填范围: x >= 0

data.video_attributes

object

仅视频模型返回。未配置的标量为 null，列表可为空；具体输入组合仍须遵循模型 API 限制。

Hide child attributes

data.video_attributes.modes

string[]

必填

data.video_attributes.resolutions

string[]

必填

data.video_attributes.default_resolution

string | null

必填

data.video_attributes.min_duration_seconds

integer | null

必填

data.video_attributes.max_duration_seconds

integer | null

必填

data.video_attributes.supports_audio

boolean | null

必填

data.video_attributes.aspect_ratios

string[]

必填

data.top_provider

object

配置 max_output_tokens 时返回。

Hide child attributes

data.top_provider.max_completion_tokens

integer

必填

与 max_output_tokens 相同的最大输出 token 数。

必填范围: x >= 0

对话补全

图片生成

Midjourney

视频生成

向量嵌入

语音转写

语音合成

决策评估

实用接口

Get Models

授权

请求头

查询参数

响应