Workflows and video types

Azimo offers six ready-made workflows, each for a different kind of business video; this page explains what each one is for, what to prepare and how to write the smallest request that works.

The catalogue at a glance#

Custom workflows are coming soon.

GET /v1/playground (or azimo playground) returns the same catalogue. It also tells you whether your account can use each workflow right now (available, with a reason when it cannot) and gives a runnable example for each. Add ?lang=en for English text.

Every request below goes to POST /v1/plans. Once the plan is ready, start production with POST /v1/videos; see the Quickstart. Set the length with options.duration_max (seconds) and the format with options.width and options.height: 16:9 is 1920×1080, 9:16 is 1080×1920 and 1:1 is 1080×1080.

Project introduction (project)#

Use it to explain a project to prospects or partners. The structure is fixed: pain point, solution, advantages, ending on one next step.

Provide all seven fields in options.content_data; leaving one out returns a 422. They are project_name, audience_role (who it is for), pain_scenario, solution_summary (one-sentence definition), solution_steps (two or three steps), advantages_with_evidence (each advantage with its source) and call_to_action. Upload screenshots, pilot reports or similar material if you have them.

{
  "prompt": "Calm, clear, business tone.",
  "options": {
    "workflow": "explainer", "video_type": "project", "duration_max": 60,
    "content_data": {
      "project_name": "NorthLeaf Route",
      "audience_role": "Owners of grocery chains with 5 to 30 stores",
      "pain_scenario": "Suppliers deliver at different times each morning, the loading bay is blocked and produce reaches the shelves late.",
      "solution_summary": "A shared delivery-scheduling service that gives each area one delivery window.",
      "solution_steps": "1) Stores confirm tomorrow's order. 2) Orders are grouped by area with one window per route. 3) Drivers follow the combined route.",
      "advantages_with_evidence": "Fewer separate deliveries | source: pilot summary provided by the client | shorter waits at the bay.",
      "call_to_action": "Book a demo."
    }
  }
}

Person card (profile_card)#

Use it for a vertical, interview-style clip about one person: their story, expertise and contact details, easy to share.

Provide the person's story in prompt: name, role, what they have done, a client quote and how to get in touch. Upload a clear photo of the person; the first image is used as their photo, and without one the person on screen will not be them. TXT, MD and PDF files such as a CV are added to the story. The format must be 1080×1920.

{
  "prompt": "Zhou Yanzhi, founder of Spruce Woodworks. Twelve years as a furniture designer; builds custom furniture only from locally reclaimed timber. Client quote: two years on, the drawers of my desk still glide. Contact: book through the workshop front desk.",
  "assets": ["<asset id of the person's photo>"],
  "options": {"workflow": "profile_card", "duration_max": 60, "width": 1080, "height": 1920}
}

If you want voice-over and footage without the person on screen, use the structured type personal instead (workflow: explainer); its fields are listed by GET /v1/video-types.

Product introduction (product)#

Use it to show in about 30 seconds who a product is for, why it stands out and how it is used, then point to one clear way to buy or enquire.

Provide seven fields: product_name, audience_role (who it is for), usage_scenario, main_benefits (up to three), demonstration (actions that can be shown), evidence (where each claim comes from) and purchase_action. Product photos and a spec sheet are strongly recommended; the product will look the way your pictures show it.

{
  "assets": ["<asset id of a product photo>"],
  "options": {
    "workflow": "explainer", "video_type": "product", "duration_max": 30,
    "content_data": {
      "product_name": "Pliva Fold Kettle",
      "audience_role": "Business travellers who stay in hotels",
      "usage_scenario": "Late at night in a hotel room, wanting a hot drink before bed.",
      "main_benefits": "Folds flat into a laptop bag; boils two cups; the lid locks shut.",
      "demonstration": "Unfold, fill, switch on, pour into a cup, fold flat again.",
      "evidence": "Spec sheet and test footage provided by the client.",
      "purchase_action": "Search for Pliva Fold Kettle in the brand's official store."
    }
  }
}

Company introduction (corporate)#

Use it to present your positioning, core business, capabilities and proof in about a minute, as an opener for partnership conversations.

Provide seven fields: company_name, positioning, audience_role, core_business, capabilities, evidence and cooperation_action. The more concrete your case studies, certificates and site photos, the better.

{
  "options": {
    "workflow": "explainer", "video_type": "corporate", "duration_max": 60,
    "content_data": {
      "company_name": "Fernwick Packaging Co., Ltd.",
      "positioning": "Recyclable protective packaging for e-commerce and food brands.",
      "audience_role": "E-commerce and food brands with regular shipping volume",
      "core_business": "Moulded-fibre trays, mailer inserts and cushions made to fit each product.",
      "capabilities": "In-house structural design, a moulding line and a testing lab.",
      "evidence": "Case studies and drop-test reports from three customers, provided by the client.",
      "cooperation_action": "Send us your product dimensions and request a sample."
    }
  }
}

Short-drama ad (short_drama)#

Use it for an ad told as a short drama, around 30 seconds, with a real story arc that carries your brand into the viewer's memory.

Provide a prompt that names the characters, setting, conflict and turn, the tone, and the closing product shot and brand line. You can attach a script or brand material as TXT, PDF or PPTX. Formats: 16:9, 9:16 or 1:1.

{
  "prompt": "A 30-second ad-style micro-drama for a fictional brand, Warm Lamp Coffee. Late at night, a tired designer, Lin, finds a hand-drip coffee and a note from her flatmate: 'I checked tomorrow's slides for you. Go to sleep.' She smiles, sips, and the light turns warm. End on the product and the brand line.",
  "options": {"workflow": "short_drama", "duration_max": 30, "width": 1080, "height": 1920}
}

E-commerce ad (ecommerce_ad)#

Use it for a vertical e-commerce ad that turns product details and everyday use into a reason to tap through to the listing.

Provide product and packaging photos; they matter most. In the prompt, describe the product, the shots, the colours, the voice, and anything that must not be said (for example, no health claims). If the material is not enough, the video may stop at needs_input and ask you for more. Formats: 16:9, 9:16 or 1:1.

{
  "prompt": "A 30-second vertical e-commerce ad for Qingye Tea Crystals, in jasmine green tea and roasted oolong, individual stick packs, hot or cold. Show a macro of crystals dissolving in a glass and both packs side by side; gentle female voice-over. Use only what the pack photos show; no health claims.",
  "assets": ["<asset id of a pack photo>"],
  "options": {"workflow": "creative_video", "duration_max": 30, "width": 1080, "height": 1920, "subtitles": true}
}

What we check before delivery#

Every video goes through automatic checks before it is delivered; the exact checks vary a little by workflow. The results are in the video's result.qa.

• Specs: resolution, frame rate and length match the request, there is an audio track, and the whole file decodes cleanly.
• Structure: for structured types, every section is present and in order, and sections that need evidence cite the material you gave.
• Content: the narration is transcribed and compared with what the film should say, including numbers and units.
• Brand and text: the brand name is pronounced correctly, and the end card's brand, contact details and call to action are complete and not cut off.
• Picture: each shot is checked for quality, text-only frames included; landscape footage in a vertical film keeps the whole picture.
• Sound: narration is complete, in sync with the picture, and the end card stays up long enough to read.
• No invention: figures, career history, case studies and results without a source do not appear in the film.
• If any check fails, the video ends as rejected, never as complete.

How to write a good brief#

• Say three things in one sentence: what the film is about, who watches it, and what they should do next.
• Describe a specific person and moment ("a business traveller in a hotel room late at night"), not "everyone".
• Give at most three selling points, each with a source or a demonstration that can be filmed.
• Only include numbers you can back up; if you have no data, describe what you actually do.
• Write names, slogans and contact details exactly as they should appear; they are used verbatim.
• Upload real product photos, portraits and documents; the film follows your material.
• Say what must not appear, such as promotions, health claims or competitor names.
• Keep the length within the workflow's range, and when a plan comes back needs_input, read its requirements first.

For every field, see the API reference.