Create Job

Single-shot draft+submit. Kept for the existing Platform-Storage upload flow (inputs already exist in workspace before the user clicks Generate). The two-phase /draft + /submit flow is preferred for new clients — see project_nail_art_storage_layout.md memory.

post/api/jobs

Request

  • Base URL: https://api.tintin-x.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.tintin-x.com/api/jobs
  • Auth: HTTP bearer

Request body

nail_set_s3_keystring nullable
nail_set_labelstring nullable
hand_s3_keysstring[] nullable
hand_template_idsstring[] nullable
harmonize_num_imagesinteger
nail_shape'almond' | 'square' | 'coffin' | 'round' | 'oval' | 'squoval' | 'stiletto' nullable
nail_length'super_short' | 'short' | 'medium' | 'long' nullable
shape_termsstring nullable
output_aspect'auto' | '21:9' | '16:9' | '3:2' | '4:3' | '5:4' | '1:1' | '4:5' | '3:4' | '2:3' | '9:16' | '4:1' | '1:4' | '8:1' | '1:8' nullable
output_max_kbinteger nullable
output_format'png' | 'jpg' | 'webp' nullable
output_resolution'2K' | '4K' nullable
collection_tagstring nullable

Response

Successful Response

idstring uuid required
series_idstring uuid required
status'draft' | 'pending' | 'running' | 'succeeded' | 'failed' required
nail_set_s3_keystring required
total_cents_chargedinteger required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.