GEN Song Mixes API
Backend/API-first DJ-style song mixing. Base URL `https://agent.gen.pro/v1`.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/gen-pro:gen-pro-song-mixes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Auto Content Engine Song Mixes API
description: 'The GEN Auto Content Engine API takes a raw idea all the way to a published video — agent setup, idea research, vidsheet production, layer composition, render, and publish.
## The 5-step journey
Every operation belongs to one phase of a 5-step user journey. Each operation carries an `x-phase` extension you can filter on:
| Phase | Meaning |
|-------|---------|
| `setup` | Step 1 — Set Up Your Agent (identity, voice, personality, API keys, workspaces) |
| `ideas` | Step 2 — Generate Content Ideas (trending data, research, refinement, preferences) |
| `convert` | Step 3 — Convert Idea to Vidsheet (clone template or build custom engine) |
| `edit` | Step 4 — Edit & Generate (cells, layers, creation cards, trigger + poll) |
| `export` | Step 5 — Export & Publish (render, download, publish to social) |
Full journey-oriented docs: https://api.gen.pro
## Authentication
All endpoints require authentication via one of:
- **API Key** (recommended): Pass your API key in the `X-API-Key` header. Create keys on the agent''s API page in the GEN dashboard.
- **JWT**: Pass a Bearer JWT in the `Authorization: Bearer ` header.
## Base URLs
```
https://api.gen.pro/v1 — agent setup, vidsheets, generations, renders, publishing
https://agent.gen.pro/v1 — content ideas, research, conversations, chat
https://agent-core.gen.pro/v1 — agent core (brand profile, watchlists, scheduled tasks)
https://python.gen.pro — social publishing integration (connect, schedule, remove posts)
```
Each operation carries its own `servers` entry, so a generated client or a
hand-written call goes to the backend that serves the route.
## Credits
All `/v1/vidsheet/` endpoints require an active GEN credit balance.
If your organization has no usable credits, requests return `422` with error code `usable_gen_credit_required`.
Credits can be funded with x402 by calling `POST /v1/x402_credit_purchase`
with `workspace_id` plus `amount_usd` or `credits`. If `network` is omitted,
GEN returns every configured payment option in `payment_methods` and
`payment_required.accepts`; show the Sui, Solana, and Base options to the
user or calling agent and sign one selected accept entry. Workspace funding
wallets are backend settlement infrastructure; the user-facing payment
choices are the returned payment methods.'
version: 1.0.0
contact:
name: GEN Support
url: https://gen.pro
license:
name: Proprietary
servers:
- url: https://api.gen.pro/v1
description: Auto Content Engine API
- url: https://agent.gen.pro/v1
description: Agent Chat API
- url: https://agent-core.gen.pro/v1
description: Agent Core API (watchlists)
- url: https://python.gen.pro
description: Publishing integration API (social connect and scheduling)
security:
- apiKey: []
- bearerAuth: []
tags:
- name: Song Mixes
description: Backend/API-first DJ-style song mixing. Base URL `https://agent.gen.pro/v1`.
paths:
/audio/mixes:
post:
operationId: createSongMix
servers:
- url: https://agent.gen.pro/v1
x-mcp-tool: gen_generate
x-mcp-branch: create_song_mix
x-phase: ideas
summary: Create a song-mix job
description: 'Creates a backend song-mix job/status object that combines multiple songs
into one long DJ-style audio output. The default prompt asks GEN to mix
the songs in optimal order by BPM, key, and mood with professional
transitions.
**Base URL:** `https://agent.gen.pro/v1`
The contract is live now. Until the Mixxx-compatible renderer worker is
installed, responses return `status: pending_engine` and `output_url:
null` rather than fabricating a final audio file.'
tags:
- Song Mixes
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SongMixRequest'
responses:
'202':
description: Song-mix job/status object
content:
application/json:
schema:
$ref: '#/components/schemas/SongMixJob'
'401':
$ref: '#/components/responses/Unauthorized'
'422':
description: Invalid song-mix request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/audio_matching_jobs:
post:
operationId: postAudioMatchingJobs
x-phase: ideas
summary: Vidsheet action —
tags:
- Song Mixes
requestBody:
required: true
content:
application/json:
schema:
type: object
description: JSON request body.
required:
- agent_id
- user_job
properties:
agent_id:
type: string
description: Agent context; the controller reads params[:agent_id] (`require_agent!`).
user_job:
type: object
properties:
data: {}
project_id: {}
container_id: {}
container_type: {}
responses:
'200':
description: Success.
content:
application/json:
schema:
type: object
properties:
user_job_id: {}
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ApiValidationError'
x-mcp-tool: gen_vidsheet_action
x-mcp-branch: <flat ops>
/recommended_sounds:
get:
operationId: getRecommendedSounds
x-phase: ideas
summary: Discover — recommended sounds
tags:
- Song Mixes
responses:
'200':
description: Success.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
description: '`DataWarehouse::RecommendedSoundResource`.'
properties:
id: {}
sound_title: {}
sound_author: {}
sound_url: {}
sound_thumbnail_url: {}
sound_tags: {}
genre: {}
mood: {}
keywords: {}
energy_level: {}
instrumentation: {}
duration_seconds: {}
tempo_bpm: {}
latest_videos:
type: array
items: {}
video_count:
type: integer
meta:
type: object
properties:
window_days:
type: integer
search_type: {}
dw_audio_ids:
type: array
items: {}
dw_error: {}
fallback_used:
type: boolean
degraded:
type: boolean
degraded_reason: {}
local_only:
type: boolean
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ApiValidationError'
x-mcp-tool: gen_discover
x-mcp-branch: media.recommended_sounds
/sound_libraries:
get:
operationId: getSoundLibraries
x-phase: ideas
summary: Discover — sound library
tags:
- Song Mixes
responses:
'200':
description: Success.
content:
application/json:
schema:
type: array
items:
type: object
properties:
sound_id: {}
title: {}
sound_url: {}
author: {}
tags: {}
thumbnail_url: {}
video_count: {}
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ApiValidationError'
x-mcp-tool: gen_discover
x-mcp-branch: media.sound_library
components:
schemas:
ApiError:
type: object
required:
- code
properties:
code:
type: string
description: The stable machine-readable failure code.
message:
type: string
description: Human-readable failure detail.
errors:
type: array
description: Field-level validation failures.
items:
type: object
retryable:
type: boolean
description: Whether retrying can succeed without changing the request.
new_change_set_required:
type: boolean
description: Whether the caller must begin a new edit group.
funding_error_kind:
type: string
description: The credit or payment failure category.
Error:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable error message.
error_code:
type: string
description: Machine-readable error code.
SongMixJob:
type: object
required:
- job_id
- status
- prompt
- tracks
- engine
- output_format
- transition_style
- auto_order
- message
- next_step
properties:
job_id:
type: string
status:
type: string
enum:
- pending_engine
- pending_song_generation
prompt:
type: string
tracks:
type: array
items:
$ref: '#/components/schemas/SongMixTrack'
engine:
type: string
example: mixxx_or_compatible
output_format:
type: string
example: mp3
transition_style:
type: string
example: professional
auto_order:
type: boolean
example: true
desired_duration_seconds:
type: integer
nullable: true
minimum: 30
maximum: 7200
output_url:
type: string
nullable: true
message:
type: string
next_step:
type: string
SongMixRequest:
type: object
properties:
tracks:
type: array
maxItems: 25
items:
$ref: '#/components/schemas/SongMixTrack'
prompt:
type: string
nullable: true
transition_style:
type: string
nullable: true
default: professional
output_format:
type: string
enum:
- mp3
- wav
default: mp3
auto_order:
type: boolean
default: true
desired_duration_seconds:
type: integer
minimum: 30
maximum: 7200
nullable: true
generate_missing_count:
type: integer
minimum: 1
maximum: 25
nullable: true
SongMixTrack:
type: object
properties:
title:
type: string
nullable: true
artist:
type: string
nullable: true
url:
type: string
format: uri
nullable: true
asset_id:
type: string
nullable: true
bpm:
type: number
minimum: 40
maximum: 240
nullable: true
key:
type: string
nullable: true
mood:
type: string
nullable: true
responses:
ApiValidationError:
description: Validation failed or the request could not be processed.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
Unauthorized:
description: Missing or invalid authentication.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Unauthorized
error_code: unauthorized
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-API-Key
description: Personal Access Token (PAT). Create one in Settings > API Keys.
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Bearer JWT issued by the GEN dashboard sign-in.