Character portraitCrop 1
NovelAI
Purpose-built illustration, manga, and character art with granular creative controls.
InputPrompttext
Models2available
FlowAsyncresult URL
Price8 quotaper image
Character portraitCrop 1Character portraitCrop 2Character portraitCrop 3Character portraitCrop 4Examples
Prompt to image, in context
Prompt
bright blue-haired fantasy character portrait, ornate costume
- Model
- curated
- Size
- 1024×1024
Character portrait
A bright character study with expressive styling, an ornate blue costume, and a clean luminous palette.
Capabilities
What you can build with NovelAI
Prompt driven generation
Submit a concise prompt and get production-ready image output through one TTAPI job.
Core controls only
Keep integration simple with prompt, model, output settings, and callback handling.
Async result flow
Use polling or webhook callbacks so long-running generations do not block your UI.
Ready for product UI
Return NovelAI results that can be displayed, stored, or passed into downstream workflows.
Pricing
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
API request
Headers and submit parameters
Use the endpoint below with your TTAPI key and the request fields shown.
/novelai/text-to-imageSubmit a NovelAI text-to-image task.
Official reference/novelai/image-to-imageTransform a reference image with NovelAI.
Official reference/novelai/fetchRetrieve the generated NovelAI task result.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringrequiredPositive illustration prompt.
modelenumrequirednai-diffusion-4-5-full or nai-diffusion-4-5-curated.
nintegeroptionalNumber of images to generate.
widthintegeroptionalOutput width in pixels.
heightintegeroptionalOutput height in pixels.
stepsintegeroptionalDiffusion step count.
scalenumberoptionalPrompt guidance scale.
negative_promptstringoptionalElements and qualities to avoid.
quality_togglebooleanoptionalEnable the documented quality preset.
samplerstringoptionalSampling algorithm.
noise_scheduleenumoptionalkarras, exponential, or polyexponential.
character_promptsobject[]optionalCharacter prompt and position definitions.
vibe_transferobject[]optionalAtmosphere reference images and strengths.
character_referenceobject[]optionalCharacter and style reference definitions.
hook_urlstringoptionalCallback URL for job completion.
Integrate
From key to first result
Copy the resolved endpoint, authentication headers, and request body for this model.
curl --request POST \
--url https://api.ttapi.io/novelai/text-to-image \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"prompt":"anime character portrait, detailed eyes","model":"nai-diffusion-4-5-curated","n":1,"width":1024,"height":1024,"steps":23,"scale":5,"quality_toggle":true,"sampler":"Euler Ancestral","noise_schedule":"karras","hook_url":"https://example.com/webhooks/novelai"}'
