Upload Media

POST /api/v1/media/upload

Upload images or videos to use as input for caption generation, image generation, or publishing.

Request

Send a multipart/form-data request with the file and metadata.

Headers

Form Fields

Supported Formats

Example

Upload an Image

curl -X POST https://powerpost.ai/api/v1/media/upload \
  -H "x-api-key: pp_live_sk_YOUR_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
  -F "file=@photo.jpg" \
  -F "type=image"

Upload a Video

curl -X POST https://powerpost.ai/api/v1/media/upload \
  -H "x-api-key: pp_live_sk_YOUR_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
  -F "file=@video.mp4" \
  -F "type=video"

Response

{
  "media_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "image",
  "file_name": "photo.jpg",
  "file_size": 245000,
  "mime_type": "image/jpeg",
  "created_at": "2026-01-10T18:30:00Z"
}

Response Fields

Using Uploaded Media

Once uploaded, use the media_id in other endpoints:

Caption generation — Pass media_ids to the Generate Content endpoint:

{
  "media_ids": ["a1b2c3d4-..."],
  "post_types": ["instagram-feed"],
  "research_mode": "regular"
}

Image generation — Pass as style_images to the Generate Images endpoint:

{
  "prompt": "Product photo in the same style",
  "style_images": ["a1b2c3d4-..."],
  "size": "square"
}

Publishing — Attach to posts via Create post:

{
  "items": [{ "post_type": "instagram-feed", "content": "...", "media_ids": ["a1b2c3d4-..."] }]
}

Storage

Uploaded and generated media is retained until you delete it — there is no automatic expiration. Storage is billed monthly based on usage. Uploads require a positive credit balance.

Errors