Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: GenMagic Benchmarks API
version: 1.0.0
description: 'GenMagic is one studio for every generative AI model. Turn a single prompt into text, images, video, audio, music, or code, and route it to the best model automatically. New models the day they launch.
OpenAI-compatible REST API plus a remote Model Context Protocol server at /api/mcp (Streamable HTTP, protocol 2025-06-18). Authenticate with an API key minted at https://genmagic.co/get-api-key; the model catalog (GET /api/v1/models) also answers without one. Billed pay-as-you-go against a prepaid USD balance; cost and remaining balance are returned in response headers.'
servers:
- url: https://genmagic.co
security:
- bearerAuth: []
tags:
- name: Benchmarks
paths:
/api/v1/benchmarks:
get:
operationId: listBenchmarks
summary: List benchmarks with definitions
description: 'Every benchmark in the matrix, described identically (what it tests, metric, status, maintainer, source). A pure lookup: spends no credits. Each links to /api/v1/benchmarks/{id} for its model leaderboard. This is a lookup and spends no credits.'
security:
- bearerAuth: []
responses:
'200':
description: Success.
headers:
X-RateLimit-Limit:
schema:
type: string
description: The key's request quota for the current rate-limit window.
X-RateLimit-Remaining:
schema:
type: string
description: Requests left for this key in the current rate-limit window.
X-RateLimit-Reset:
schema:
type: string
description: Seconds until the current rate-limit window resets.
'401':
description: 'authentication_error: missing or invalid API key.'
'429':
description: 'rate_limit_error: over 300 requests/minute for this key.'
parameters:
- name: category
in: query
required: false
schema:
type: string
enum:
- reasoning
- math
- coding
- agentic
- chat
- multimodal
- long-context
- composite
description: Filter by benchmark category.
description: Filter by benchmark category.
tags:
- Benchmarks
/api/v1/benchmarks/{id}:
get:
operationId: getBenchmark
summary: Benchmark detail and model leaderboard
description: 'One benchmark''s full definition plus its model leaderboard ranked best-first, each score carrying its source and a link to the original. Answers ''which model is best at benchmark X''. A pure lookup: spends no credits. This is a lookup and spends no credits.'
security:
- bearerAuth: []
responses:
'200':
description: Success.
headers:
X-RateLimit-Limit:
schema:
type: string
description: The key's request quota for the current rate-limit window.
X-RateLimit-Remaining:
schema:
type: string
description: Requests left for this key in the current rate-limit window.
X-RateLimit-Reset:
schema:
type: string
description: Seconds until the current rate-limit window resets.
'401':
description: 'authentication_error: missing or invalid API key.'
'429':
description: 'rate_limit_error: over 300 requests/minute for this key.'
parameters:
- name: id
in: path
required: true
schema:
type: string
description: The benchmark id, e.g. gpqa-diamond (see /api/v1/benchmarks).
description: The benchmark id, e.g. gpqa-diamond (see /api/v1/benchmarks).
- name: limit
in: query
required: false
schema:
type: integer
description: Max models to return (default 100, max 500).
description: Max models to return (default 100, max 500).
tags:
- Benchmarks
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'GenMagic API key in the form gm_live_..., sent as Authorization: Bearer <key>. Also accepted as x-api-key.'