Skip to main content
POST
Generate Static Creative with Saved Request

Authorizations

x-api-key
string
header
required

A server-side Bily API key created under Settings > AI tools > Access keys. Select the intended workspace before creating it.

Headers

x-bily-organization-id
string

An organization ID returned by GET /context or GET /organizations. Omit it when a scoped key supplies the organization. Otherwise provide it when no organization is selected.

Example:

"org_01J8W7T9G3E6ZQ4M2K5N8P1R0S"

x-bily-generation-request-attempt
string

Fresh UUIDv4 for this one POST only when consuming qualified non-admission proof; never an authorization token or key rewrite.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Path Parameters

storeUrl
string
required

Exact workspace URL returned by GET /context.

Body

application/json
sourceIntelligenceId
string
required
Pattern: ^[A-Za-z0-9._~-]{1,256}$
idempotencyKey
string
required
Pattern: ^[A-Za-z0-9._~-]{1,256}$
quality
enum<string>
Available options:
draft,
polished
aspectRatio
enum<string>
Available options:
1:1,
4:5,
9:16,
2:3
instruction
string
Maximum string length: 500
saveToLibrary
boolean

Response

Read the returned identifier until processing reaches a terminal state. Acceptance alone does not confirm completion.

request
object
required
storeUrl
string
required