A product image for your storefront. A short film from a reference photo. A new version of yesterday’s campaign. You can now create these from your own app with the Creativly API—and keep the results in the same projects you use in Creativly.
Generate one API key in your account settings, send a prompt and choose a model. Your existing credits cover the generation. There is no separate API wallet to fund or provider account to connect for platform generation.
The image above was created through the live API with Nano Banana 2.1 during release verification. It used one credit at the settings tested.
Make the creative step part of your workflow.
Add an image step to a content tool. Turn selected product photos into short videos. Build a review screen that lets someone request a new background or change a detail. You control the experience; Creativly creates the media and saves the originals.
Images and videos can share a session. If you animate or edit an owned asset without specifying a project, its existing project and session are reused. For a new text prompt, the API reuses your API workspace. You can also choose an existing owned project and session explicitly.
Your first image is one request.
Open your account menu, choose API Keys and generate your key. Copy it once and store it on your server. The separate BYOK tab keeps your existing provider credentials.
curl https://api-v2.creativly.ai/v1/generations \
-H "Authorization: Bearer $CREATIVLY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: product-photo-001' \
-d '{
"model": "nano-banana-2.1",
"prompt": "A sky-blue espresso cup on an ivory plinth, soft studio light",
"max_credits": 1
}'The API checks your settings and credit cap before accepting the request. A 202 response gives you a job ID, the credits charged and a link to the saved session. Check that job for progress, then retrieve its completed assets. You do not need a separate quote call to start; a quote endpoint is available when your interface needs to show the price first.
Keep the same idempotency key when retrying the same request after a timeout. It recovers the accepted job instead of charging for another copy. Use a new key for a different request.
Animate a reference. Edit the result.
Pass an owned image asset to a compatible video model and describe the movement. For an image or video edit, use the same generation endpoint with operation: "edit", a source asset ID and your change. The original remains available alongside the new version.
Make the cup terracotta red. Preserve its shape, the lighting and the background.
New references upload directly to private storage. Reserve the file, send its bytes and complete the upload. Once moderation marks it ready, use its asset ID in a generation. Images can be up to 10 MiB and videos up to 50 MiB, within your account’s storage allowance.
Choose models without rebuilding the integration.
The model catalog reflects Creativly’s current registry and your account access. Read a model’s details for its supported operations, references, defaults and allowed settings. The initial API supports size, aspect ratio, duration, resolution, quality, audio and seed where applicable. Unsupported options are rejected, never silently ignored.
A generation can request up to four outputs. Each result has its own status and asset ID. Original download links last fifteen minutes; request a fresh link with the asset ID whenever you need one.
Prefer a conversation? Keep using MCP.
The MCP connection still uses your normal Creativly sign-in and approved project access. It does not need an API key. Compatible clients can now open a private upload picker; reconnect with upload permission to add new references. Clients without that interface can use signed upload tickets. A file attached to a chat is not automatically accessible to every client.
Start with the API guide for the request fields, video and edit examples, upload steps and credit behavior. Your first integration can stay small: one key, one request, one saved result.
Common questions
Do I need separate credits for the API?
No. Accepted generations use your existing Creativly wallet and the selected model’s current pricing. Model discovery, quotes, status checks and uploads do not spend generation credits. Your plan and storage limits still apply. This API uses platform billing; provider credentials in BYOK remain separate.
Where do I get my Creativly API key?
Sign in to Creativly, open your account menu and choose API Keys. Generate a key and copy it once. Keep it on your server. You can revoke or regenerate it there. The separate BYOK tab is for provider credentials.
Can I edit an image or video I already have?
Yes. Use an owned completed asset or upload a private reference and wait for moderation. Send the same generation endpoint an edit operation, the source asset ID, a compatible model and the change you want. The original is preserved.
Which model settings are available?
The live catalog reports models and settings available to your account. The initial API accepts size, aspect ratio, duration, resolution, quality, audio and seed where the chosen model supports them. It does not expose every provider-specific option.
Is an API key required for MCP?
No. MCP connects through Creativly sign-in and project consent. API keys are for your own software. Both paths save work in Creativly and use the same account credits.