studio

Generate a Studio logo

Start a new asynchronous logo generation, then poll getStudioGeneration until it succeeds or fails.

post/studio/generations/logo

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/studio/generations/logo
  • 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 logo for.

descriptionstring

Optional creative direction, limited to 500 characters.

type'let-ai-choose' | 'image-icon' | 'abstract-icon' | 'wordmark' | 'letter-mark' | 'mascot' required
style'let-ai-choose' | 'classic' | 'innovative' | 'bold' | 'luxury' | 'warm-inviting' | 'fun-playful' | 'retro' | 'confidence' | 'joy' | 'peace' | 'purity' | 'trust' required
textTreatment'let-ai-choose' | 'full-domain' | 'tld-subtle' | 'tld-highlight' | 'stacked-domain' required
typography'let-ai-choose' | 'sans-serif' | 'serif' | 'slab-serif' | 'script' | 'monospace' required
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.