damdafa-com

damdafa-com Generation API

The Generation API from damdafa-com — 3 operation(s) for generation.

GitHub OpenAPI

Operations 3

POST /api/v1/generate Create Generation #
GET /api/v1/generate/cost Get Generation Cost #
GET /api/v1/generate/style-catalog Get Style Catalog #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/damdafa-com/openapi/damdafa-com-generation-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-generation-create-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-track-lead-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-user-update-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-purchase-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-auth-create-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-referral-redeem-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-user-profile-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-action-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-telemetry-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-user-profile-in-db-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-mockup-screen-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-render-job-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-screenshot-group-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-export-job-schema.json
📊
JSONSchema
https://artifacts.apis.io/damdafa-com/json-schema/damdafa-com-text-element-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/damdafa-com:damdafa-com-generation-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

damdafa-com-generation-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Damdafa Com Generation API
  version: 1.0.0
  description: 'Operations tagged Generation across 2 of this provider''s published API definitions: foto-damdafa-com-openapi.json, foto-damdafa-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /dreamhome
tags:
- name: Generation
paths:
  /api/v1/generate:
    post:
      tags:
      - Generation
      summary: Create Generation
      description: Queue a new HomeDecor image generation request.
      operationId: create_generation_api_v1_generate_post
      security:
      - HTTPBearer: []
      parameters:
      - name: ProviderId
        in: header
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/AUTH_PROVIDER'
          - type: 'null'
          title: Providerid
      - name: X-Provider-Id
        in: header
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/AUTH_PROVIDER'
          - type: 'null'
          title: X-Provider-Id
      - name: X-Device-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Device-Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenerationCreateRequest'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerationCreateResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: Authentication failed
                error_code: unauthorized
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '500':
          description: Internal Server Error
          content:
            application/json:
              example:
                error: Internal server error
                error_code: internal_error
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: /dreamhome
  /api/v1/generate/cost:
    get:
      tags:
      - Generation
      summary: Get Generation Cost
      description: Return estimated generation cost for quality tiers.
      operationId: get_generation_cost_api_v1_generate_cost_get
      security:
      - HTTPBearer: []
      parameters:
      - name: ProviderId
        in: header
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/AUTH_PROVIDER'
          - type: 'null'
          title: Providerid
      - name: X-Provider-Id
        in: header
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/AUTH_PROVIDER'
          - type: 'null'
          title: X-Provider-Id
      - name: X-Device-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Device-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenerationCostResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: Authentication failed
                error_code: unauthorized
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '500':
          description: Internal Server Error
          content:
            application/json:
              example:
                error: Internal server error
                error_code: internal_error
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: /dreamhome
  /api/v1/generate/style-catalog:
    get:
      tags:
      - Generation
      summary: Get Style Catalog
      description: Return style catalog metadata without prompt content.
      operationId: get_style_catalog_api_v1_generate_style_catalog_get
      security:
      - HTTPBearer: []
      parameters:
      - name: ProviderId
        in: header
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/AUTH_PROVIDER'
          - type: 'null'
          title: Providerid
      - name: X-Provider-Id
        in: header
        required: false
        schema:
          anyOf:
          - $ref: '#/components/schemas/AUTH_PROVIDER'
          - type: 'null'
          title: X-Provider-Id
      - name: X-Device-Id
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Device-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StyleCatalogResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: Authentication failed
                error_code: unauthorized
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '500':
          description: Internal Server Error
          content:
            application/json:
              example:
                error: Internal server error
                error_code: internal_error
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: /dreamhome
components:
  schemas:
    HomeDecorCategory:
      type: string
      enum:
      - interior
      - exterior
      - garden
      - floor
      - paint
      title: HomeDecorCategory
    CatalogPaletteSchema:
      properties:
        paletteId:
          anyOf:
          - $ref: '#/components/schemas/MagicStyle'
          - $ref: '#/components/schemas/ColorPalette'
          title: Paletteid
      type: object
      required:
      - paletteId
      title: CatalogPaletteSchema
    ColorPalette:
      type: string
      enum:
      - amethyst_dream
      - antique_sage
      - arctic_frost
      - arctic_lavender
      - autumn_harvest
      - azure_mirage
      - blush_and_brass
      - bohemian_rhapsody
      - candy_shop
      - coastal_breeze
      - cyberpunk_city
      - desert_oasis
      - desert_sand
      - earthy_harmony
      - earthy_hues
      - emerald
      - emerald_city
      - fairy_tale
      - forest
      - forest_retreat
      - french_country
      - fuschia
      - gothic_romance
      - industrial_chic
      - jewel_tones
      - lavender_fields
      - lilac_love
      - mid_century_modern
      - midnight_velvet
      - millennial_gray
      - minimalist_white
      - monochrome_noir
      - moody_blues
      - neon
      - ocean_depths
      - ocean_mist
      - pastel
      - pastel_dream
      - peach
      - retro_diner
      - royal_elegance
      - rustic_cabin
      - safari_adventure
      - sakura_bloom
      - scandinavian_minimal
      - space_odyssey
      - spring_awakening
      - steampunk_workshop
      - summer_fiesta
      - sunset_boulevard
      - terracotta
      - tropical_paradise
      - turquoise_lagoon
      - tuscan_sun
      - twilight_blues
      - urban_jungle
      - velvet_dusk
      - vintage_charm
      - warm_neutrals
      - whimsical_wish
      - winter_wonderland
      - zen_garden
      - paint-suggestion-1
      - paint-suggestion-2
      - paint-suggestion-3
      - paint-suggestion-4
      - paint-suggestion-5
      - paint-suggestion-6
      - paint-suggestion-7
      - paint-suggestion-8
      - paint-suggestion-9
      - paint-suggestion-10
      title: ColorPalette
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    InteriorStyle:
      type: string
      enum:
      - 80s-style
      - ancient-egyptian
      - baroque
      - biophilic
      - bohemian
      - cartoon
      - chocolate
      - christmas
      - coastal
      - cottagecore
      - cozy
      - creepy
      - cyberpunk
      - gamer
      - gothic
      - japandi
      - luxury
      - medieval
      - mediterranean
      - minimalistic
      - modern
      - rainbow
      - rustic
      - ski-chalet
      - soho-style
      - tropical
      - vintage
      - wood
      - interior-suggestion-1
      - interior-suggestion-2
      - interior-suggestion-3
      - interior-suggestion-4
      - interior-suggestion-5
      - interior-suggestion-6
      - interior-suggestion-7
      - interior-suggestion-8
      title: InteriorStyle
    GardenStyle:
      type: string
      enum:
      - cottage
      - english
      - french-formal
      - japanese
      - mediterranean
      - minimalist
      - xeriscape
      - garden-suggestion-1
      - garden-suggestion-2
      - garden-suggestion-3
      - garden-suggestion-4
      - garden-suggestion-5
      - garden-suggestion-6
      - garden-suggestion-7
      - garden-suggestion-8
      - garden-suggestion-9
      - garden-suggestion-10
      title: GardenStyle
    MagicStyle:
      type: string
      enum:
      - surprise_me
      title: MagicStyle
    CatalogStyleSchema:
      properties:
        categoryId:
          $ref: '#/components/schemas/HomeDecorCategory'
        styleId:
          anyOf:
          - $ref: '#/components/schemas/MagicStyle'
          - $ref: '#/components/schemas/InteriorStyle'
          - $ref: '#/components/schemas/ExteriorStyle'
          - $ref: '#/components/schemas/GardenStyle'
          - $ref: '#/components/schemas/FloorStyle'
          title: Styleid
      type: object
      required:
      - categoryId
      - styleId
      title: CatalogStyleSchema
    QualityTier:
      type: string
      enum:
      - cheap
      - fast
      - best
      title: QualityTier
    AUTH_PROVIDER:
      type: string
      enum:
      - firebase
      - google
      - apple
      title: AUTH_PROVIDER
    GenerationCreateResponse:
      properties:
        generationId:
          type: string
          title: Generationid
        status:
          type: string
          title: Status
      type: object
      required:
      - generationId
      - status
      title: GenerationCreateResponse
      description: Response schema returned after queueing a generation.
    GenerationCreateRequest:
      properties:
        categoryId:
          $ref: '#/components/schemas/HomeDecorCategory'
          description: The category ID (interior, exterior, garden, floor, paint)
        generationId:
          anyOf:
          - type: string
          - type: 'null'
          title: Generationid
          description: Existing generation ID to retry in-place. Allowed only when retrying a failed generation.
        originalImageUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Originalimageurl
          description: URL of the uploaded image
        originalAssetId:
          anyOf:
          - $ref: '#/components/schemas/MagicStyle'
          - $ref: '#/components/schemas/InteriorStyle'
          - $ref: '#/components/schemas/ExteriorStyle'
          - $ref: '#/components/schemas/GardenStyle'
          - $ref: '#/components/schemas/FloorStyle'
          - $ref: '#/components/schemas/ColorPalette'
          - type: 'null'
          title: Originalassetid
          description: ID of the selected example asset
        referenceImageUrls:
          items:
            type: string
          type: array
          title: Referenceimageurls
          description: Reference image URL list
        referenceAssetIds:
          items:
            anyOf:
            - $ref: '#/components/schemas/MagicStyle'
            - $ref: '#/components/schemas/InteriorStyle'
            - $ref: '#/components/schemas/ExteriorStyle'
            - $ref: '#/components/schemas/GardenStyle'
            - $ref: '#/components/schemas/FloorStyle'
            - $ref: '#/components/schemas/ColorPalette'
          type: array
          title: Referenceassetids
          description: Reference asset ID list
        styleIds:
          items:
            anyOf:
            - $ref: '#/components/schemas/MagicStyle'
            - $ref: '#/components/schemas/InteriorStyle'
            - $ref: '#/components/schemas/ExteriorStyle'
            - $ref: '#/components/schemas/GardenStyle'
            - $ref: '#/components/schemas/FloorStyle'
          type: array
          title: Styleids
          description: Style ID list for the selected category.
        selectedSegments:
          anyOf:
          - items:
              type: integer
            type: array
          - type: 'null'
          title: Selectedsegments
          description: List of selected segment IDs
        segmentationJobId:
          anyOf:
          - type: string
          - type: 'null'
          title: Segmentationjobid
          description: The job ID of the segmentation
        segmentationResultUrl:
          anyOf:
          - type: string
          - type: 'null'
          title: Segmentationresulturl
          description: Direct URL for segmentation result payload (preferred over segmentationJobId when provided)
        paletteId:
          anyOf:
          - type: string
          - type: 'null'
          title: Paletteid
          description: Palette ID. Ignored for garden category.
        prompt:
          anyOf:
          - type: string
          - type: 'null'
          title: Prompt
          description: User's AI instruction text
        qualityTier:
          $ref: '#/components/schemas/QualityTier'
          description: 'Quality tier label: cheap|fast|best'
          default: cheap
      type: object
      required:
      - categoryId
      title: GenerationCreateRequest
      description: Request schema for creating a new generation.
    ExteriorStyle:
      type: string
      enum:
      - art-deco
      - brutalist
      - chinese
      - cottage
      - farm-house
      - french
      - gothic
      - italianate
      - japanese
      - mediterranean
      - midcentury
      - middle-eastern
      - minimalistic
      - modern
      - moroccan
      - ski-chalet
      - spanish
      - exterior-suggestion-1
      - exterior-suggestion-10
      title: ExteriorStyle
    CatalogCategorySchema:
      properties:
        categoryId:
          $ref: '#/components/schemas/HomeDecorCategory'
      type: object
      required:
      - categoryId
      title: CatalogCategorySchema
    StyleCatalogResponse:
      properties:
        categories:
          items:
            $ref: '#/components/schemas/CatalogCategorySchema'
          type: array
          title: Categories
        styles:
          items:
            $ref: '#/components/schemas/CatalogStyleSchema'
          type: array
          title: Styles
        palettes:
          items:
            $ref: '#/components/schemas/CatalogPaletteSchema'
          type: array
          title: Palettes
      type: object
      required:
      - categories
      - styles
      - palettes
      title: StyleCatalogResponse
    FloorStyle:
      type: string
      enum:
      - carpet
      - epoxy
      - hard-wood
      - laminate
      - marble
      - natural-stone
      - persian-rug
      - polished-concrete
      - scandinavian
      - solid-wood
      - terrazzo
      - tile
      - tile-2
      - vinyl-plank
      - floor-suggestion-1
      - floor-suggestion-2
      - floor-suggestion-3
      - floor-suggestion-4
      - floor-suggestion-5
      - floor-suggestion-6
      - floor-suggestion-7
      title: FloorStyle
    GenerationCostResponse:
      properties:
        cheap:
          type: number
          title: Cheap
        fast:
          type: number
          title: Fast
        best:
          type: number
          title: Best
      type: object
      required:
      - cheap
      - fast
      - best
      title: GenerationCostResponse
      description: Estimated generation costs by quality tier.
    ErrorResponseSchema:
      properties:
        error:
          type: string
          title: Error
          description: Human-readable error message
        error_code:
          type: string
          enum:
          - internal_error
          - unauthorized
          - forbidden
          - authentication_failed
          - access_denied
          - not_found
          - conflict
          - job_in_progress
          - rate_limit_exceeded
          - validation_error
          - quota_exceeded
          - premium_required
          - insufficient_balance
          - timeout
          - service_unavailable
          - external_service_error
          - auth_required
          - invalid_token
          - auth_failed
          - auth_or_device_required
          - verification_failed
          - signature_content_mismatch
          - cancelled
          - email_not_verified
          title: Error Code
          description: Machine-readable error code
        details:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Details
          description: Additional error details
      type: object
      required:
      - error
      - error_code
      title: ErrorResponseSchema
      description: Standard error response schema for OpenAPI documentation
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- foto-damdafa-com-openapi.json
- foto-damdafa-com-openapi.json