Skip to content

Reference ​

Quick access to technical specifications and resources.

Documentation Index ​

API Reference ​

ResourceDescription
AuthenticationAPI keys and auth methods
Images APIImage generation and management
Sessions APISession state management
Characters APICharacter library operations
Products APIProduct reference operations
Style Presets APIPreset management
Usage APIAnalytics and quotas
Admin APITenant administration
Error CodesComplete error reference

MCP Tools Reference ​

CategoryTools
Generationgenerate_image, generate_with_character, generate_with_product
Editingedit_image, continue_editing, edit_uploaded_image
Characterscreate_character, list_characters, get_character, update_character, delete_character
Productscreate_product_reference, list_product_references, get_product_reference, delete_product_reference
Style Presetscreate_style_preset, list_style_presets, update_style_preset, delete_style_preset
Analyticsget_usage_stats, get_account_summary, get_session_history, search_images

Self-Hosting Reference ​

ResourceDescription
ConfigurationEnvironment variables and secrets
Database SchemaD1 tables and relationships
Tenant ManagementMulti-tenant operations
OperationsMonitoring and maintenance
ScalingPerformance optimization
TroubleshootingCommon issues and solutions

Quick Reference Cards ​

API Key Format ​

sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  # Production key
sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  # Test key

Response Format ​

json
{
  "data": { /* ... */ }
}

Error Response ​

json
{
  "error": "Human readable message",
  "code": "OPTIONAL_ERROR_CODE",
  "details": { /* optional */ }
}

Common HTTP Status Codes ​

CodeMeaning
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limited
500Server Error

Aspect Ratios ​

ValueDimensionsUse Case
square1:1Social media, avatars
portrait3:4Mobile, stories
landscape4:3Desktop, thumbnails
16:916:9Widescreen, video
9:169:16Vertical video, stories

Image Limits ​

ParameterLimit
Prompt length16,384 characters (Pro), 8,192 (Flash)
Images per request4
Reference images14 (Pro), 3 (Flash)
Max uploaded image20 MB and 4,194,304 pixels (about 4.2 MP)
Thumbnail size200x200 px

Next Steps ​

Released under the MIT License.