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 Agent 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: Agent
paths:
/api/v1/agent/turn:
post:
operationId: agentTurn
summary: Agent reply plus a cross-modal asset plan
description: The API face of the studio Agent. Send a conversation; it replies in character and returns a plan of on-brand assets to make. Planning is orchestration and is not billed (you then generate each asset via the matching endpoint). 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.'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- messages
properties:
messages:
type: array
items:
type: object
description: Conversation [{ role, content }] ending in a user message.
tags:
- Agent
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.'