Create and publish a visual

Inspect a template schema, create a visual, retain its ID, verify media output, and publish as a separate authorized action.

Scope: external API/MCP visual generation, including n8n and Make. The in-app AI Agent's video restriction is not a restriction on this workflow. Generation consumes credits according to the requested job. Confirm authorization before starting a new paid attempt.

Prompt for your assistant:

Find a Blotato template for the image, carousel, or video I describe. Read its inputs, generate the visual, and check its status until it finishes or returns an error. Show me the finished media before following my publishing instructions.

Using Blotato API or MCP

1. Call blotato_list_visual_templates, or GET /v2/videos/templates, to select a template and inspect its inputs.

2. Call blotato_create_visual, or POST /v2/videos/from-templates, with templateId, template-specific inputs, a prompt when needed, and render: true for rendered output.

Use the exact template ID returned by the listing. Do not strip a path ID to its UUID. MCP's template listing supplies id, description, and inputs. For REST, request fields=id,name,description,inputs when you need the template name and input schema.

1. Save the returned item.id.

2. Call blotato_get_visual_status, or GET /v2/videos/creations/:id, at least 15 seconds apart.

3. Stop when item.status is done, or when item.error or a failure state appears.

4. Use the returned item.mediaUrl or item.imageUrls for the publish workflow.

Do not invent template input fields. Use the template's current schema. Inspect inputs without generating instead of running a blank generation request. Generated media URLs do not need another upload. The completed visual has not been posted to a social platform until the publish workflow succeeds.

See Create Visual, Get Visual Status, and the template catalog.

Request and output example

1. Retrieve templates and inspect the current inputs. The following quote-card template is an example, not a substitute for choosing the customer's requested output. Keep the complete template ID.

2. Call blotato_create_visual with this shape. For REST, send the same body to POST https://backend.blotato.com/v2/videos/from-templates with Content-Type: application/json and the blotato-api-key header:

{
  "templateId": "/base/v2/quote-card/77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd/v1",
  "inputs": {
    "title": "Daily practice",
    "quotes": ["Practice the skill you want to improve every day."],
    "aspectRatio": "4:5"
  },
  "render": true
}

1. Save item.id from the response. A queueing status means accepted, not finished:

{
  "item": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "queueing"
  }
}

1. Call blotato_get_visual_status with {"id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}, or GET /v2/videos/creations/a1b2c3d4-e5f6-7890-abcd-ef1234567890. Substitute the saved ID and wait at least 15 seconds between checks.

2. On done, read the returned item.imageUrls for image outputs or item.mediaUrl for video. Do not guess the URL or reuse the source input as the generated result.

3. Stop on item.error, creation-from-template-failed, or insufficient-credits. A draft or script-ready record without completed media is not ready to publish. Inspect visual status for next steps.

4. Review the output before a separate publish request. Use the returned URLs directly without another upload.

Set a waiting limit. If generation remains unfinished, return its ID and current state. Do not create another paid job because a status request failed or time elapsed. For a brand requirement, follow Brand Kit because REST and MCP expose different fields.

Using Blotato Web App

1. Follow Make your first AI video to choose a template and generate a visual.

2. Review the finished output.

3. Follow the recommended workflow to publish it.

For images, see AI Images. For credit questions, see Video FAQs.