Μετάβαση στο περιεχόμενο

Birefnet

Ενσωμάτωση

id μοντέλου birefnet/v2/video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Έως 2,07 $ ανά εκτέλεση χρέωση βάσει της πραγματικής χρήσης, το υπόλοιπο επιστρέφεται Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
BiRefNet Αφαίρεση φόντου #utility#editing

Αφαιρεί φόντα από βίντεο, με έξι επιλογές μοντέλου, matting και έξοδο σε mp4, webm, mov ή gif

BiRefNet · Βίντεο

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται video_url
Αποθέστε ένα αρχείο ή

URL που προσδιορίζει το βίντεο του οποίου θα αφαιρεθεί το φόντο.

Για προχωρημένους operating_resolution · video_output_type · video_quality · video_write_mode · model · output_mask · refine_foreground
operating_resolution προεπιλογή 1024x1024

Ανάλυση εργασίας, με το '2304x2304' να περιορίζεται στο μοντέλο 'General Use (Dynamic)'. Για εικόνες εισόδου υψηλής ανάλυσης, οι υψηλότερες ρυθμίσεις βελτιώνουν την ακρίβεια εξόδου.

video_output_type προεπιλογή X264 (.mp4)

Τύπος εξόδου για το βίντεο που προκύπτει.

video_quality προεπιλογή high

Επίπεδο ποιότητας για το βίντεο που προκύπτει.

video_write_mode προεπιλογή balanced

Λειτουργία εγγραφής για το βίντεο που προκύπτει.

προεπιλογή General Use (Light)

Επιλογή μοντέλου αφαίρεσης φόντου: το 'General Use (Light)' αντιστοιχεί στο BiRefNet, είναι το αρχικό μοντέλο του αποθετηρίου BiRefNet και συνιστάται για τις περισσότερες χρήσεις. Το 'General Use (Light 2K)' αντιστοιχεί στο BiRefNet_lite-2K και χρησιμοποιεί το αρχικό μοντέλο που εκπαιδεύτηκε σε εικόνες 2K. Το 'General Use (Heavy)' αντιστοιχεί στο BiRefNet_lite και προσφέρει μεγαλύτερη ακρίβεια με πιο αργή επεξεργασία. Το 'Matting' αντιστοιχεί στο BiRefNet-matting και έχει εκπαιδευτεί ειδικά για matting εικόνων. Το 'Portrait' αντιστοιχεί στο BiRefNet-portrait και έχει εκπαιδευτεί ειδικά σε εικόνες πορτρέτων. Το 'General Use (Dynamic)' αντιστοιχεί στο BiRefNet_dynamic και υποστηρίζει μεταβλητές αναλύσεις από 256x256 έως 2304x2304.

POST /run/birefnet/v2/video?wait=20 προσφορά → 2,07 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/birefnet/v2/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Εκτέλεση αυτού του αιτήματος

Το κλειδί σας παραμένει σε αυτό το πρόγραμμα περιήγησης: αποστέλλεται μόνο στο Doitong API και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το Birefnet

Εφαρμόζει κατάτμηση BiRefNet σε κάθε καρέ ενός βίντεο από το `video_url`. Τα μοντέλα περιλαμβάνουν Light, Light 2K, Heavy, Matting, Portrait και Dynamic, με αναλύσεις λειτουργίας έως 2304x2304 (μόνο για το μοντέλο Dynamic). Η έξοδος μπορεί να είναι X264 mp4, VP9 webm, ProRes 4444 mov ή GIF, με τις ρυθμίσεις `video_quality` και `video_write_mode`. Μπορεί να ζητηθεί ξεχωριστό βίντεο μάσκας.

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
modelπροαιρετικό
Τύποςenum
ΠροεπιλογήGeneral Use (Light)
General Use (Light)General Use (Light 2K)General Use (Heavy)MattingPortraitGeneral Use (Dynamic)
Επιλογή μοντέλου αφαίρεσης φόντου: το 'General Use (Light)' αντιστοιχεί στο BiRefNet, είναι το αρχικό μοντέλο του αποθετηρίου BiRefNet και συνιστάται για τις περισσότερες χρήσεις. Το 'General Use (Light 2K)' αντιστοιχεί στο BiRefNet_lite-2K και χρησιμοποιεί το αρχικό μοντέλο που εκπαιδεύτηκε σε εικόνες 2K. Το 'General Use (Heavy)' αντιστοιχεί στο BiRefNet_lite και προσφέρει μεγαλύτερη ακρίβεια με πιο αργή επεξεργασία. Το 'Matting' αντιστοιχεί στο BiRefNet-matting και έχει εκπαιδευτεί ειδικά για matting εικόνων. Το 'Portrait' αντιστοιχεί στο BiRefNet-portrait και έχει εκπαιδευτεί ειδικά σε εικόνες πορτρέτων. Το 'General Use (Dynamic)' αντιστοιχεί στο BiRefNet_dynamic και υποστηρίζει μεταβλητές αναλύσεις από 256x256 έως 2304x2304.
operating_resolutionπροαιρετικό
Τύποςenum
Προεπιλογή1024x1024
1024x10242048x20482304x2304
Ανάλυση εργασίας, με το '2304x2304' να περιορίζεται στο μοντέλο 'General Use (Dynamic)'. Για εικόνες εισόδου υψηλής ανάλυσης, οι υψηλότερες ρυθμίσεις βελτιώνουν την ακρίβεια εξόδου.
output_maskπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει αν η μάσκα αφαίρεσης φόντου περιλαμβάνεται στην έξοδο.
refine_foregroundπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ελέγχει τη βελτίωση του προσκηνίου με βάση την εκτιμώμενη μάσκα.
video_urlαπαιτείται video
Τύποςurl · video
URL που προσδιορίζει το βίντεο του οποίου θα αφαιρεθεί το φόντο.
video_output_typeπροαιρετικό
Τύποςenum
ΠροεπιλογήX264 (.mp4)
X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
Τύπος εξόδου για το βίντεο που προκύπτει.
video_qualityπροαιρετικό
Τύποςenum
Προεπιλογήhigh
lowmediumhighmaximum
Επίπεδο ποιότητας για το βίντεο που προκύπτει.
video_write_modeπροαιρετικό
Τύποςenum
Προεπιλογήbalanced
fastbalancedsmall
Λειτουργία εγγραφής για το βίντεο που προκύπτει.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "birefnet/v2/video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 2070,
    "usd": "2.07",
    "charged": 2070,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "mask_video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Τα αρχεία σας, η επιλογή σαςΚάθε outputs[].url είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά GB-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Βίντεο μετά την αφαίρεση φόντου.
mask_video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | nullΜάσκα που εφαρμόζεται κατά την αφαίρεση φόντου.

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/birefnet/v2/video.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt