Angle Generation

The Angle Generation endpoint allows you to take an existing image and reposition the virtual camera to generate new viewing angles (e.g., front, back, side profiles) while preserving the model, clothing, textures, and lighting.

Model Name: angle-generation

Lifecycle: stable

Processing Time: ~10s–20s

Output Format: Auto (JPEG or PNG)

Delivery Methods: URL, Base64 (preview)

Credits: 1 to 5 per angle generated (depends on quality)

Request

Submit your image and the desired angles 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": "angle-generation",
           "inputs": {
             "imageUrl": "https://example.com/front-view.jpg",
             "angleIds": ["back", "leftSide"],
             "quality": "2k"
           }
         }'

Response

Because angle generation can take up to 20 seconds, the /v1/run endpoint returns a 201 Created status immediately with an asynchronous job id. You must poll the Status API using GET /v1/status/{id} to retrieve the final results. 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": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Once the status changes to "succeeded", the output field will contain an array of URLs pointing to your generated images. The images are returned in the exact same order as the angleIds array provided in your initial request:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "succeeded",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": [
    "https://cdn.fititon.app/users/123/results/angle-123-0.png",
    "https://cdn.fititon.app/users/123/results/angle-123-1.png"
  ]
}

Request Parameters

Required Parameters

imageUrlRequiredstring

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

Pro Tip: Front-facing photos produce the most consistent multi-angle results. Avoid angled or side-facing source images — front views give the AI the most to work with, whereas angled shots force the AI to hallucinate missing structural details.

Formatting Requirement When submitting a Base64 string, it must include the standard data URI prefix (e.g., data:image/jpeg;base64,...).

angleIdsRequiredarray of strings

An array of angle identifiers you wish to generate. Available options are:

"front": Front View
"back": Back View
"leftSide": Left Side (90°)
"rightSide": Right Side (90°)
"left45": Left 45°
"right45": Right 45°

Optional Parameters

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

Output resolution tier. Default: 1k

ratiostring

Aspect ratio override (e.g., 16:9, 3:4). If empty, the system defaults to the original image's aspect ratio.

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 scales linearly based on the number of angles requested, and depends on the chosen output quality tier.

Formula: Cost = QualityCredits × NumberOfAngles

Quality Tier	Credits Per Angle
1k (Default)	1
2k	3
4k	5

Example: Requesting ["back", "leftSide", "rightSide"] at 1k quality costs 3 credits total. Requesting the same 3 angles at 4k quality costs 15 credits total.