FLUX.2 Pro Edit API

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "blackforestlabs/flux-2-pro/edit",
  "input": {
    "prompt": "Using image 1 (the grandmother) and image 2 (the boy) as identity references and image 3 as the location, create one warm documentary photograph of the grandmother teaching the boy to fold jiaozi dumplings at the flour-dusted wooden table in the kitchen from image 3. Keep both people exactly recognisable: the grandmother's pinned silver hair with black clip, smile lines, maroon knitted cardigan, white collar and jade earrings; the boy's bowl haircut, missing front tooth, mustard corduroy overalls and striped shirt. The grandmother stands beside and slightly behind the boy, guiding his small hands as he pinches a dumpling closed; a tray of neat finished dumplings and a few lopsided ones sits in front of him, with a rolling pin and a bowl of pork-and-chive filling nearby. Preserve the brick stove, iron wok, bamboo steamer, frosted window with red paper-cuts, and hanging garlic and chillies from image 3. Soft afternoon window light, a little flour in the air, natural skin texture, believable hands, 35mm lens. No text, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-01.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-02.png",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-2-pro/edit/v1/01/input-03.png"
    ],
    "size": "3:2",
    "resolution": "1K"
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done