Skip to content
Tapotik AI

Command Palette

Search for a command to run...

Image API

Text-to-image generation with style presets from photorealism to 3D glass, plus 4K upscaling and mask-based edits. Images are returned as signed URLs valid for 24 hours.

Generate images

POST/v1/images/generations

Generation is synchronous for single images (typically 2–4 seconds) and asynchronous for batches — batch requests return a job you can poll or subscribe to via webhooks.

terminalbash
curl https://api.tapotik.ai/v1/images/generations \
  -H "Authorization: Bearer $TAPOTIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tapotik-image-3",
    "prompt": "Isometric glass workstation floating in deep navy space, soft violet rim light",
    "size": "1536x1024",
    "style": "render_3d",
    "n": 1
  }'
app/generate.tstypescript
const result = await client.images.generate({
  model: "tapotik-image-3",
  prompt:
    "Isometric glass workstation floating in deep navy space, soft violet rim light",
  size: "1536x1024",
  style: "render_3d",
  n: 1,
});

console.log(result.data[0].url);        // signed URL, 24h TTL
console.log(result.data[0].revised_prompt); // prompt after safety/quality rewrite

Request parameters

ParameterTypeDescription
modelstring · requiredtapotik-image-3 (flagship) or tapotik-image-3-fast.
promptstring · requiredDescription of the image, up to 4,000 characters.
sizestring · default 1024x10241024x1024, 1536x1024, 1024x1536 or 2048x2048.
stylestringStyle preset — see the table below. Omit for the model default.
ninteger · 1–8 · default 1Number of variations. n > 1 runs as an async batch job.
negative_promptstringElements to avoid, e.g. "text, watermark, extra fingers".
seedintegerFix the seed for reproducible generations.

Style presets

PresetLook
photorealNatural light photography, accurate skin and materials.
render_3dGlossy 3D renders — glass, chrome, soft studio lighting.
illustrationEditorial flat illustration with bold shapes.
animeClean line art with cel shading.
pixelRetro pixel art, fixed 1:1 grid.

Upscaling

POST/v1/images/upscale

Upscale any generated image to 4K. Pass the image_id from a previous generation — source files never need to be re-uploaded.

typescript
const upscaled = await client.images.upscale({
  image_id: "img_9f3b2c",
  factor: 4, // 2 or 4
});

Credits

A standard 1024×1024 image costs 1 credit; 2048x2048 and 4× upscales cost 3 credits. Failed generations are never billed, and safety-filtered prompts return 422 content_policy_violation without consuming credits.

Generated images are yours: every plan grants full commercial usage rights to outputs, per our Terms of Service.