/artificialanalysis/models

POST /api/artificialanalysis/models

Price: 1 credit

Get an Artificial Analysis model by alias

How to use it

The deep record for one model: per-evaluation scores, the cost and token accounting behind the intelligence index, openness scoring and licence links that the leaderboard row leaves out. Aliases are variant-level, so 'claude-fable-5-1' and its reasoning-effort siblings are separate models here — take the alias from a search result rather than guessing it from a product name.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• model string required — Model alias or model page URL (examples: "claude-fable-5-1", "https://artificialanalysis.ai/models/gpt-4o"; minLength: 1)

Response

• @type string (default: "ArtificialanalysisModel")
• alias string required
• url string required
• id string nullable
• name string nullable
• short_name string nullable
• creator_name string nullable
• creator_alias string nullable
• creator_country string nullable
• creator_url string nullable
• creator_image string nullable
• release_alias string nullable
• release_name string nullable
• release_date string nullable
• knowledge_cutoff_date string nullable
• is_deprecated boolean nullable
• deprecated_to string nullable
• is_reasoning boolean nullable
• is_open_weights boolean nullable
• open_source_categorization string nullable
• license_name string nullable
• license_url string nullable
• model_weights_url string nullable
• openness object (default: {})
• param_class string nullable
• size_class string nullable
• parameter_count_billions number nullable
• active_parameter_count_billions number nullable
• context_window_tokens integer nullable
• effort_alias string nullable
• effort_label string nullable
• effort_level integer nullable
• host_model_count integer nullable
• reasoning_token_count integer nullable
• input_modalities array (default: [])
• output_modalities array (default: [])
• intelligence_index number nullable
• is_intelligence_index_estimated boolean nullable
• intelligence_index_time_per_task number nullable
• intelligence_index_cost object (default: {})
• intelligence_index_cost_per_task object (default: {})
• intelligence_index_output_tokens_per_task object (default: {})
• intelligence_index_token_count object (default: {})
• briefcase object (default: {})
• timescale_data object (default: {})
• evaluations object nullable
  • @type string (default: "ArtificialanalysisEvaluations")
  • aime25 number nullable
  • analyst_agent number nullable
  • apex_agents number nullable
  • automation_bench number nullable
  • automation_bench_partial_score number nullable
  • briefcase_total_cost number nullable
  • briefcase_breakdown object (default: {})
  • critpt number nullable
  • enterprise_ops_gym number nullable
  • gdp_pdf_all_pass number nullable
  • gdpval number nullable
  • gdpval_normalized number nullable
  • gpqa number nullable
  • harvey_lab number nullable
  • hle number nullable
  • ifbench number nullable
  • it_bench_sre number nullable
  • lcr number nullable
  • livecodebench number nullable
  • mlcr_overall number nullable
  • mmmu_pro number nullable
  • omniscience number nullable
  • omniscience_accuracy number nullable
  • omniscience_non_hallucination number nullable
  • omniscience_hallucination_rate number nullable
  • scicode number nullable
  • tau2 number nullable
  • tau_banking number nullable
  • terminalbench_hard number nullable
  • terminalbench_v21 number nullable
  • terminalbench_v40 number nullable
• pricing object nullable
  • @type string (default: "ArtificialanalysisPricing")
  • price_class string nullable
  • price_1m_input_tokens number nullable
  • price_1m_output_tokens number nullable
  • cache_hit_price number nullable
  • cache_write_price number nullable
  • cache_hit_discount_percent number nullable
  • price_per_1k_images number nullable
  • cost_per_task number nullable
  • blended_price_0to1to1 number nullable
  • blended_price_0to3to1 number nullable
  • blended_price_0to100to1 number nullable
  • blended_price_100to1to1 number nullable
  • blended_price_7to2to1 number nullable
• performance object nullable
  • @type string (default: "ArtificialanalysisPerformance")
  • median_output_tokens_per_second number nullable
  • p05_output_tokens_per_second number nullable
  • q25_output_tokens_per_second number nullable
  • q75_output_tokens_per_second number nullable
  • p95_output_tokens_per_second number nullable
  • median_time_to_first_token_seconds number nullable
  • p05_time_to_first_token_seconds number nullable
  • q25_time_to_first_token_seconds number nullable
  • q75_time_to_first_token_seconds number nullable
  • p95_time_to_first_token_seconds number nullable
  • median_time_to_first_answer_token_seconds number nullable
  • median_end_to_end_response_time_seconds number nullable
  • median_reasoning_time_seconds number nullable
  • time_to_first_answer_token_breakdown object (default: {})
  • end_to_end_response_time_breakdown object (default: {})
  • by_prompt_type object (default: {})
  • data_source string nullable
  • data_source_provider_name string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — No model with that alias Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.