# Videó közzététele YouTube, Instagram, Facebook és Threads felületen

Kanonikus URL: https://sosoapi.ai/hu/docs/video-publishing

Töltsd fel egyszer a videódat, majd minden célhelyhez készíts bejegyzést. Az útmutató médiaellenőrzést, platformbeállításokat, YouTube-láthatóságot és a megjelenés ellenőrzését ismerteti. Közzétételi szerződés ellenőrizve: 2026. október 20.

## 1. Készíts elő egy kész videómédiát

Tölts fel helyi videót, vagy importálj nyilvános videó-URL-t a munkaterületedre. A feltöltést vagy importot készenlétig ellenőrizd, majd a regisztrált asset_id és kanonikus asset_url értékét használd a bejegyzésben.

A SosoAPI ellenőrzi a videó tényleges konténerét, hosszát, méreteit és kodekjeit, ahol ezt a platform megköveteli. A fájlnév, a hívó által megadott MIME-típus vagy a lejátszható előnézet nem igazolja a jogosultságot. Időzítés előtt ellenőrizd a videóhoz és hanghoz fűződő jogaidat, valamint a kötelező jelöléseket.

- Az eredeti videót és borítómédiát ugyanabban az engedélyezett munkaterületben tartsd.

- Ellenőrizd a teljes piszkozat jogosultságát a pontos fiókhoz és kívánt formátumhoz.

- Ha az előkészítés sikertelen, vizsgáld meg a meglévő állapotát; pusztán a lassú válasz miatt ne indíts ismételt importálásokat.

## 2. Válaszd ki a célhely videóformátumát

Válaszd a célfiók által támogatott formátumot és beállításokat. Kész médiát újrahasználhatsz, de minden platform saját provider_payload értéket igényel.

Videóközzétételi lehetőségek

| Célhely | provider_payload választás | Időzítés előtt ellenőrizd |

| --- | --- | --- |

| Instagram | platform: instagram; VIDEO, REELS vagy STORY_VIDEO a helyzetnek megfelelően. | Professzionális fiók és megfigyelt képességek; Stories esetén Business-jogosultság kell. A Reels-specifikus beállítások maradjanak a Reels formátumnál. |

| Facebook-oldal | platform: facebook; VIDEO, REELS vagy STORY_VIDEO a helyzetnek megfelelően. | Oldalazonosság, közzétételi engedély és CREATE_CONTENT feladat; támogatott média- és formátumbeállítások. |

| Threads | platform: threads; VIDEO. | Jogosult közzétételi fiók és kész videó; a csak szöveges mellékletek nem vonatkoznak VIDEO payloadra. |

| YouTube-csatorna | platform: youtube; VIDEO. | Kifejezett cím, kategória, láthatóság és visszavonási mód; natív időzítéshez kezelési engedély. |

## 3. Ellenőrzött YouTube-videó időzítése

Használd az API-referencia szerversegédjét. Az asset_id helyére a regisztrált pozitív egész számot, az asset_url helyére a kanonikus URL-t írd. Válaszd ki a csatorna tényleges fiókazonosítóját és egy jövőbeli közzétételi időpontot.

Ez a példa nyilvános közzétételt kér a kiválasztott időpontban. Futtatás előtt erősíttesd meg ezt a láthatóságot a felhasználóval. A contains_synthetic_media értékét a videónak megfelelően állítsd be; a false csak példa. Az UNSCHEDULE_KEEP_PRIVATE arra kéri a YouTube-ot, hogy visszavonás esetén a még közzé nem tett natív időzítést tartsa privátként.

```
await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<youtube-channel-account-uuid>",
  "caption": null,
  "hashtags": [],
  "media": [
    {
      "kind": "video",
      "asset_id": "<ready-video-asset-id>",
      "url": "<canonical-video-asset-url>"
    }
  ],
  "provider_payload": {
    "platform": "youtube",
    "publish_options": {
      "post_type": "VIDEO",
      "title": "A reviewed product walkthrough",
      "description": "Our team introduces the product in one short walkthrough.",
      "category_id": "24",
      "privacy_status": "public",
      "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
      "contains_synthetic_media": false
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-video-intent>"
});
```

- [Közzétételi API-referencia](https://sosoapi.ai/hu/docs/publishing-api-reference)

## 4. Tedd egyértelművé az adatvédelmi, Shorts- és szolgáltatói korlátokat

YouTube-hoz VIDEO post_type értéket használj. Megadhatsz surface_expectation: SHORT értéket, de a YouTube dönti el, hogy a feltöltés Shortnak számít-e. A fájlnév vagy az álló tájolás önmagában nem igazolja ezt.

A feltöltési és a natív időzítések kezelésére szóló engedély különbözik. Ellenőrizd, támogatja-e a csatorna az opcionális funkciókat, például a bélyegképeket; az elérhetőség ismeretlen is lehet. A Google feltöltési referenciája ismerteti az engedélyezési és metaadatkövetelményeket; a SosoAPI a saját támogatott mezőit és az összekapcsolt fiókot is ellenőrzi.

A YouTube és más platformok feldolgozási vagy moderálási időt igényelhetnek a videóhoz, és kvótáik továbbra is érvényesek. Az elfogadott feltöltés nem jelenti, hogy a videó nyilvánosan látható.

- [Google: YouTube videos.insert referencia](https://developers.google.com/youtube/data/reference/rest/v3/videos/insert)

- [Fiók- és formátumképesség-mátrix](https://sosoapi.ai/hu/docs/publishing-capabilities)

## 5. Ellenőrizd ugyanannak a bejegyzésnek a végső eredményét

Mentsd el a Scheduled Post azonosítóját, és ellenőrizd kézbesítését és végső eredményét. Ha van, nyisd meg a szolgáltatói linket. A scheduled vagy publishing azt jelenti, hogy a végső eredmény még függőben van.

Az elfogadott időzítés a kliens szétkapcsolása után is folytatódik a szerveren. Módosítás előtt ugyanazt a bejegyzést olvasd. Visszavonáshoz az aktuális verziót és elérhető visszavonási műveletet használd. Már közzétett videó törlésére más szabályok vonatkoznak.

Videó több platformon történő újrahasználatakor ellenőrizd minden célhely követelményeit. Ezek a példák kérésformátumokat mutatnak; nem futtatnak és nem tesznek közzé videót erről az oldalról.

- [Saját ügynökkel végzett ellenőrzési folyamat](https://sosoapi.ai/hu/docs/claude-code-codex-social-publishing)

- [Közzétételi API-referencia](https://sosoapi.ai/hu/docs/publishing-api-reference)