Skip to main content

​
Regenerate Sequence API

Regenerates a specific sequence of an existing video. Useful to fix a failed sequence or change the animation of a particular sequence.
​
POST /api/video-editor/generate/sequence/{id}

​
Authentication

All requests must include the header:
  • x-api-key: YOUR_API_KEY

​
Headers

​
x-api-key
string
required
Your IACrea API key
​
Content-Type
string
required
Must be application/json

​
URL Parameters

​
id
string
required
Unique video identifier (returned by POST /api/video-editor/generate/video)

​
Request Body

​
sequenceId
string
required
Identifier of the sequence to regenerate (found in generatedContent of the response from GET /api/video-editor/generate/video/{id})
​
sequence
object
Optional parameters for the new generation
​
sequence.url
string
New image URL to use (if different from original). Optional.
​
sequence.effect
string
New animation type to use. Optional.

​
Responses

​
200 — Regeneration started

​
status
string
Status: "START_GENERATION"
​
generationId
string
Identifier of the new generation for this sequence
​
creditsTotal
number
Remaining video credits
​
creditsUsed
number
Credits used

​
400 — Validation error

Returned if the video id or sequenceId is invalid.

​
401 — Unauthorized

Returned if x-api-key is missing or invalid.

​
404 — Not Found

Returned if the video or sequence does not exist.

​
500 — Server Error

Internal server error.

​
Request Example

curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/sequence/550e8400-e29b-41d4-a716-446655440000' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "sequenceId": "660e8400-e29b-41d4-a716-446655440001",
    "sequence": {
      "url": "https://example.com/new-image.jpg",
      "effect": "CAMERA_PUSH_OUT"
    }
  }'

​
Response Example

{
  "status": "START_GENERATION",
  "generationId": "770e8400-e29b-41d4-a716-446655440003",
  "creditsTotal": 47,
  "creditsUsed": 3
}

​
Important Notes

  • Regenerating a sequence resets the video status to "pending" and cancels the final render if it was in progress
  • You must use GET /api/video-editor/generate/video/{id} to track the progress of the new generation
  • If you do not provide sequence.url or sequence.effect, the original values will be reused
  • Regeneration consumes additional video credits