Skip to main content

Path Parameters

string
required
The ID of the model to retrieve (e.g., gpt-5.4, claude-sonnet-4-6).

Model Deletion

DELETE /v1/models/{model} is not supported. AI Sonar models are a shared public catalog, not user-owned fine-tuned model resources.

Response

string
Model identifier. It also includes lifecycle, commercial, and badges, which describe deprecation/retirement state, user charge policy, and display badges.
string
Always model.
integer
Creation timestamp.
string
Model provider.
object
AI Sonar-specific public metadata. The detail route includes logical protocol availability in accepted_request_formats and can include category, pricing_unit, capability_flags, supported_operations, pricing_provenance, request_format_summary, the full request_format_details, and scene-level agent_preferences for non-chat recommendation snapshots.

Error Handling

If the model doesn’t exist, you’ll receive a 404 error:

Non-Chat Recommendation Metadata

For non-chat models, the detail route also returns aisonar.agent_preferences.<scene>. Use it to inspect:
  • preferred_rank
  • success_rate_24h
  • sample_count_24h
  • status
  • updated_at
The public response summarizes recommendation provenance with basis.source and does not expose routing identifiers.

Public Detail Metadata

Compared with GET /v1/models, the detail route can additionally return:
  • aisonar.capability_flags
  • aisonar.supported_operations
  • aisonar.pricing_provenance
  • aisonar.request_format_summary
  • aisonar.request_format_details
  • aisonar.accepted_request_formats