---
title: "POST /v2/content/generate-image/start"
method: POST
path: "/v2/content/generate-image/start"
tags: ["v2"]
---

# POST /v2/content/generate-image/start

`POST /v2/content/generate-image/start`

## Request

- Base URL: `https://api.inside.ad/api`
- URL: `https://api.inside.ad/api/v2/content/generate-image/start`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.inside.ad/api/oauth/authorize`, token URL `https://api.inside.ad/api/oauth/token`, scopes: `content:write`)
  - API key in header `authorization`

Starts asynchronous AI image generation for a post. Returns a jobId immediately — poll "check_generate_image" with it until status is "done" (result.imageUrl), then attach it via update_post/update_post_image ("fileUrl"). Prefer "create_post" instead if you just want to write and publish one post — it handles image generation inline.

## Query parameters

- `userId` number, required

## Request body

- object
  - `platform` 'instagram' | 'threads' | 'telegram'
  - `post` string, required: The post caption/idea text to base the generated image on
  - `contentType` 'outgoing' | 'account', required
  - `contentId` number, nullable
  - `channelId` string, required
  - `model` string, nullable
  - `aspectRatio` string, nullable: e.g. "1:1", "4:5", "9:16"
  - `styleOverrides` object, nullable
    - `imageConcept` string, nullable
    - `visualStyle` string, nullable
    - `imageStyle` string, nullable
    - `textMode` number, nullable
    - `customPrompt` string, nullable
    - `useChannelInfo` number, nullable

## Response `200`

Default Response

- object
  - `jobId` string, required
  - `status` string, required

---

[API](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized.md) · [All operations](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized/llms.txt) · [OpenAPI document](https://skmtc.dev/inside/apis/inside-ad-api-documentation-v2-ai-optimized/revisions/79912b433f7f?raw)