Skip to main content
Phoenix-4.5 has two stages from one Create Face call. The face ID does not change.
  1. A zero-shot preview becomes usable early (about a minute from a photo, minutes from video). That preview has a visible watermark burned into the video.
  2. Tuning continues in the background for a few hours. When it finishes, the same face is the unwatermarked tuned version.
Poll Get Face. status answers “can I use this face?” finetune_status answers “did background tuning finish?” This page is for Phoenix-4.5. Phoenix-4 and Phoenix-3 have no preview stage. Wait for status completed; finetune_status stays unused.

​
Status fields

finetune_status values:
  • null: Fine-tune has not started. The face is not at the usable checkpoint yet.
  • training: Fine-tune is in progress.
  • completed: Fine-tune finished.
  • error: Fine-tune failed.
status error still means the create / preview job failed. That face is not usable. That is different from finetune_status error, where the preview already succeeded.
status completed on Phoenix-4.5 means the preview is ready, not that tuning is done. If you need the unwatermarked version, keep polling until finetune_status is completed.
Optional: set callback_url on Create Face to get notified as these values change.

​
If tuning errors

The preview stays available. Conversations and other uses of that face_id still work. The watermark changes to tuning failed so it is obvious the upgrade did not finish. You do not submit the photo or video again. The face ID stays the same. If you need a new attempt, create a new face. Phoenix-4 does not have this path. Its status completed means the whole job finished.