Social Studio API | Fit It On Developer Documentation

Apply highly stylized creative effects and templates to fashion images for social media.

The Social Studio endpoint applies highly stylized, creative aesthetic templates to your fashion images, turning them into eye-catching content perfectly suited for social media marketing.

Model Name: social-studio

Lifecycle: stable

Processing Time: ~15s–30s

Output Format: Auto (JPEG or PNG)

Delivery Methods: URL

Credits: 2 to 5 per generation (depends on quality)

Request

Submit your image and selected style ID to the universal /v1/run endpoint:

POSThttps://fititon.app/api/v1/run

Request Examples

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

Response

Because image generation can take up to 30 seconds, the /v1/run endpoint returns a 201 Created status immediately with an asynchronous job id. You must poll the Status API using this id to retrieve the final image. Alternatively, you can configure webhooks to receive notifications automatically. Please note that our webhook dispatcher enforces a strict 15-second timeout. Your server must acknowledge the webhook with a 2xx status code within 15 seconds, or we will consider it failed and retry it later.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

When the job completes (status: "success"), the output field will contain an array of the resulting URLs:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Request Parameters

Required Parameters

personImageRequiredstring

The source image to stylize. Can be a publicly accessible URL or a Base64-encoded image string.

Pro Tip: Full-body photos where the whole person is visible produce the best stylized results. Clear face visibility matters — the AI uses facial features to create your stylized version. Avoid group photos or images where you're partially hidden behind objects.

Formatting Requirement When submitting a Base64 string, it must include the standard data URI prefix (e.g., data:image/jpeg;base64,...). While personImage accepts Base64 strings, we strongly recommend using standard HTTP URLs for images larger than 3MB to avoid hitting global JSON payload size limits (HTTP 413) on your request.

styleIdRequiredstring

The photographic style ID to apply to the generated image. This determines lighting, aesthetic, and mood.

Available Styles:

Style Name	Style ID (`styleId`)

Optional Parameters

quality'1k' | '2k' | '4k'

Output resolution tier. Default: 1k

sampleCountinteger

Number of image variations to generate per request. Must be between 1 and 4. Default: 1

ratiostring

Aspect ratio override. If empty, the system defaults to 1:1 (ideal for Instagram/social feeds).

Supported values: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

Runtime Errors

Runtime errors for this feature use the shared set documented in Error Handling. If an error occurs during processing, the status will update to "error" and the error field will contain the specific failure reason.

Credit Cost

For Developer API requests, the cost depends on the chosen output quality tier multiplied by the sampleCount.

Formula: Cost = QualityCredits × sampleCount

Quality Tier	Credits per Image
1k (Default)	2
2k	3
4k	5