> ## Documentation Index > Fetch the complete documentation index at: https://docs.photalabs.com/llms.txt > Use this file to discover all available pages before exploring further. # Generate > Generate images from a text prompt without input images. Provide a prompt describing the desired image. Returns base64 images or signed download URLs. ## OpenAPI ````yaml https://api.photalabs.com/v1/phota/openapi.json post /v1/phota/generate openapi: 3.1.0 info: title: Phota API description: Create and manage profiles for photo editing and enhancement. version: v0.5.0 servers: - url: https://api.photalabs.com security: [] tags: - name: Studio description: Image editing, generation, and enhancement. - name: Profiles description: 'Profile lifecycle: create, query, delete.' paths: /v1/phota/generate: post: tags: - Studio summary: Generate description: |- Generate images from a text prompt without input images. Provide a prompt describing the desired image. Returns base64 images or signed download URLs. operationId: generate_v1_phota_generate_post requestBody: content: application/json: schema: $ref: '#/components/schemas/GenerateRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/EditResponse' '400': description: Invalid request or content moderation violation. content: application/json: schema: $ref: '#/components/schemas/PhotaError400Response' '401': description: Missing or invalid API key in the X-API-Key header. '402': description: Insufficient prepaid credit balance. '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/PhotaError404Response' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal error. content: application/json: schema: $ref: '#/components/schemas/PhotaError500Response' '503': description: Service temporarily unavailable. content: application/json: schema: $ref: '#/components/schemas/PhotaError503Response' security: - APIKeyHeader: [] components: schemas: GenerateRequest: properties: prompt: type: string title: Prompt description: Text prompt describing the desired edit. default: '' num_output_images: type: integer maximum: 4 minimum: 1 title: Num Output Images description: Number of output images to generate (1-4). default: 1 aspect_ratio: type: string enum: - auto - '1:1' - '3:4' - '4:3' - '9:16' - '16:9' title: Aspect Ratio description: Output aspect ratio (auto, 1:1, 3:4, 4:3, 9:16, 16:9). default: auto resolution: type: string enum: - 1K - 2K - 4K title: Resolution description: >- Output resolution (1K, 2K, 4K). Per-model support varies; see /models. default: 1K quality: anyOf: - type: string enum: - auto - low - medium - high - type: 'null' title: Quality description: >- Quality tier (auto, low, medium, high). Only supported by gpt-image-2; passing this field for other models returns 400. Omit (or pass 'auto') to let the provider pick — for gpt-image-2 this resolves to OpenAI's auto tier. Lower tiers reduce output tokens and therefore settled cost. base_model: type: string enum: - flux-2 - gpt-image-2 - nb2 - qwen-image-2 - reve title: Base Model description: >- Base model identifier. Omit to use the default base model. Unknown ids are rejected with 400; base models that do not support this endpoint's capability are also rejected with 400. default: nb2 output_format: type: string enum: - png - jpg title: Output Format description: >- Output image format (png, jpg). Default: png (will change to jpg on 2026-05-08). default: png response_mode: type: string enum: - bytes - urls title: Response Mode description: >- Response delivery mode. 'bytes': return base64-encoded image data (default). 'urls': return signed download URLs (24-hour expiry) instead of image bytes. default: bytes type: object title: GenerateRequest description: |- Request body for the generate endpoint. Provide a text prompt describing the image you want to create. Reference profiles inline using ``[[profile_id]]`` syntax to specify which people should appear in the generated image. examples: - num_output_images: 1 prompt: Generate a photo of [[abc123]] on a tropical beach EditResponse: properties: images: items: type: string type: array title: Images description: >- Output image(s) as raw base64-encoded strings. Format matches the requested output_format. Populated when response_mode='bytes', empty otherwise. download_urls: items: type: string type: array title: Download Urls description: >- Signed download URLs for each output image (24-hour expiry). Populated when response_mode='urls', empty otherwise. known_subjects: $ref: '#/components/schemas/KnownGeneratedSubjectCounts' description: >- Dictionary mapping a known subject's `profile_id` to the number of times they were generated. If multiple variations are generated, this will be the aggregated count across all variations. type: object required: - known_subjects title: EditResponse description: Response returned by the edit, generate, and enhance endpoints. PhotaError400Response: properties: detail: type: string title: Detail description: Human-readable error message. code: type: string enum: - CONTENT_MODERATION - INVALID_REQUEST title: Code description: Machine-readable error code. request_id: type: string title: Request Id description: Unique request identifier for support. type: object required: - detail - code - request_id title: PhotaError400Response description: Error response for 400 Bad Request. PhotaError404Response: properties: detail: type: string title: Detail description: Human-readable error message. code: type: string enum: - NOT_FOUND - PROFILE_NOT_FOUND - PROFILE_NOT_READY title: Code description: Machine-readable error code. request_id: type: string title: Request Id description: Unique request identifier for support. type: object required: - detail - code - request_id title: PhotaError404Response description: Error response for 404 Not Found. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError PhotaError500Response: properties: detail: type: string title: Detail description: Human-readable error message. code: type: string const: INTERNAL_ERROR title: Code description: Machine-readable error code. request_id: type: string title: Request Id description: Unique request identifier for support. type: object required: - detail - code - request_id title: PhotaError500Response description: Error response for 500 Internal Server Error. PhotaError503Response: properties: detail: type: string title: Detail description: Human-readable error message. code: type: string const: SERVICE_UNAVAILABLE title: Code description: Machine-readable error code. request_id: type: string title: Request Id description: Unique request identifier for support. type: object required: - detail - code - request_id title: PhotaError503Response description: Error response for 503 Service Unavailable. KnownGeneratedSubjectCounts: properties: counts: additionalProperties: type: integer type: object title: Counts description: >- Mapping of profile ID to the number of times that subject was generated. type: object title: KnownGeneratedSubjectCounts description: Counts of known subjects generated, keyed by profile ID. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ````