Chuyển đến nội dung chính

​
Phản hồi

​
object
string
Luôn là list.
​
data
array
Mảng các đối tượng model.Mỗi model bao gồm:
  • id (string): Định danh model
  • object (string): model
  • created (integer): Dấu thời gian tạo
  • owned_by (string): Nhà cung cấp model
  • aisonar.category (string): Danh mục model công khai
  • aisonar.pricing_unit (string hoặc null): Đơn vị giá công khai khi có
  • aisonar.capability_flags (object hoặc null): Tóm tắt năng lực công khai
  • aisonar.supported_operations (array hoặc null): Các thao tác phi-chat công khai của model
  • aisonar.pricing_provenance (object hoặc null): Metadata nguồn giá công khai
  • aisonar.public_contract_summary (object hoặc null): Tóm tắt khám phá phi-chat nhẹ, chỉ gồm public_operations và request_endpoint
  • aisonar.agent_preferences (object): Chỉ trả về khi có recommended_for
GET /v1/models được tối ưu cho khám phá. Metadata chỉ có ở trang chi tiết như capability_flags, pricing_provenance, và public_contract đầy đủ nằm ở GET /v1/models/{model}.

​
Tham số Query

​
category
string
Bộ lọc danh mục công khai tùy chọn. Hỗ trợ chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, và translation.
​
recommended_for
string
Kịch bản khuyến nghị phi-chat tùy chọn. Hỗ trợ image, video, music, 3d, tts, stt, embedding, rerank, và translation.
​
provider
string
Bộ lọc nhà cung cấp tùy chọn như openai, anthropic, google, hoặc deepseek.
​
tag
string
Bộ lọc tag model tùy chọn như chat, image, video, embedding, hoặc translation.
Khi có recommended_for, /v1/models sắp xếp model phi-chat theo snapshot tỷ lệ thành công 24 giờ đã cache mới nhất. Model có status = "insufficient_samples" vẫn hiển thị nhưng xếp sau các model đã có điểm.
curl "https://api.aisonar.dev/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model",
      "created": 1706000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1706000000,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-2.5-flash",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google"
    }
  ]
}

​
Lọc theo Nhà Cung Cấp

# Get all OpenAI models
openai_models = [m for m in models.data if m.owned_by == "openai"]

# Get all Anthropic models
anthropic_models = [m for m in models.data if m.owned_by == "anthropic"]

​
Danh Mục Model

Nhà cung cấpModel ví dụ
openaigpt-5.4, gpt-5.4-mini, gpt-5-mini, gpt-4o, dall-e-3
anthropicclaude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
googlegemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro
deepseekdeepseek-r1, deepseek-v3-2
xaigrok-4.1
moonshotkimi-k2.5
minimaxminimax-m2.1
metallama-3.3-70b, llama-3.1-405b

​
Ví dụ Khuyến nghị Agent

Response
{
  "object": "list",
  "data": [
    {
      "id": "gemini-2.5-flash-image",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google",
      "aisonar": {
        "category": "image",
        "pricing_unit": "per_request",
        "agent_preferences": {
          "image": {
            "preferred_rank": 1,
            "success_rate_24h": 0.98,
            "sample_count_24h": 423,
            "status": "ready",
            "updated_at": "2026-03-28T12:00:00.000Z",
            "basis": {
              "score_source": "clickhouse_24h",
              "channel_id": null,
              "physical_model": null
            }
          }
        }
      }
    }
  ]
}