studio

Generate a Studio poster

Start a new asynchronous poster or marketing-mockup generation, optionally using an owned successful logo generation as its reference, then poll getStudioGeneration for completion.

post/studio/generations/poster

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/studio/generations/poster
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

x-namefi-eip7702-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-accountstring

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Request body

domainstring required

Domain to create the poster or marketing mockup for.

descriptionstring

Optional creative direction, limited to 500 characters.

referenceLogoGenerationIdstring uuid

ID of a successful Studio logo generation owned by the user.

collateralType'billboard' | 'apparel' | 'vehicle' | 'product' | 'website_mockup' | 'let_ai_choose'
model'gpt-image-2.5-flare' | 'gemini-nano-banana-2.1' | 'gpt-image-2' | 'gemini-3-pro-image'

Response

OK

idstring uuid required
domainstring required
kind'logo' | 'poster' | 'animation' required
status'FAILED' | 'PENDING' | 'PROCESSING' | 'SUCCEEDED' required
referenceGenerationIdstring uuid nullable required
pollAfterSecondsunknown required
createdAtstring date-time required
updatedAtstring date-time required
startedAtstring date-time nullable required
finishedAtstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.