Initial commit with translated description

2026-03-29 14:35:55 +08:00
commit c628e2f0e0
4 changed files with 512 additions and 0 deletions
--- a/references/platforms.md
+++ b/references/platforms.md
@@ -0,0 +1,117 @@
+# Platform-Specific Parameters
+
+## TikTok
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `tiktok_title` | String | Override title for TikTok |
+| `post_mode` | String | `DIRECT_POST` (default) or `MEDIA_UPLOAD` (draft) |
+| `privacy_level` | String | `PUBLIC_TO_EVERYONE`, `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, `SELF_ONLY` |
+| `auto_add_music` | Boolean | Add background music to photos |
+| `disable_comment` | Boolean | Disable comments |
+| `brand_content_toggle` | Boolean | Paid partnership content |
+| `photo_cover_index` | Integer | Cover photo index (0-based) |
+
+## Instagram
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `instagram_title` | String | Override title |
+| `media_type` | String | `IMAGE`, `STORIES`, `REELS` |
+| `collaborators` | String | Comma-separated usernames |
+| `user_tags` | String | Comma-separated users to tag |
+| `location_id` | String | Instagram location ID |
+
+## YouTube
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `youtube_title` | String | Video title |
+| `youtube_description` | String | Video description |
+| `privacy_status` | String | `public`, `private`, `unlisted` |
+| `category_id` | String | YouTube category ID |
+| `tags` | Array | Video tags |
+| `made_for_kids` | Boolean | COPPA compliance |
+| `playlist_id` | String | Add to playlist |
+
+## LinkedIn
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `linkedin_title` | String | Override title |
+| `visibility` | String | `PUBLIC`, `CONNECTIONS`, `LOGGED_IN` |
+| `target_linkedin_page_id` | String | Organization/page URN |
+
+Get page IDs: `GET /api/uploadposts/linkedin/pages`
+
+## Facebook
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `facebook_title` | String | Override title |
+| `facebook_page_id` | String | Page ID (required for pages) |
+| `facebook_media_type` | String | `POSTS` or `STORIES` |
+
+Get page IDs: `GET /api/uploadposts/facebook/pages`
+
+Note: Personal profiles not supported by Meta API - only Pages.
+
+## X (Twitter)
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `x_title` | String | Override title |
+| `x_long_text_as_post` | Boolean | Post long text as single post (default: thread) |
+| `reply_settings` | String | `following`, `mentionedUsers`, `subscribers`, `verified` |
+| `reply_to_id` | String | Tweet ID to reply to |
+| `community_id` | String | Post to community |
+| `tagged_user_ids` | Array | Users to tag in photos (max 10) |
+
+Thread behavior: Long text auto-splits at 280 chars. Media attaches to first tweet only.
+
+## Threads
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `threads_title` | String | Override title |
+
+Supports mixed carousels (photos + videos).
+
+## Pinterest
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `pinterest_title` | String | Pin title |
+| `pinterest_board_id` | String | Target board ID (required) |
+| `pinterest_link` | String | Destination link |
+| `pinterest_alt_text` | String | Alt text for image |
+
+Get board IDs: `GET /api/uploadposts/pinterest/boards`
+
+## Reddit
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `reddit_title` | String | Post title |
+| `subreddit` | String | Target subreddit (required) |
+| `reddit_flair_id` | String | Flair ID |
+| `nsfw` | Boolean | Mark as NSFW |
+| `spoiler` | Boolean | Mark as spoiler |
+
+## Bluesky
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `bluesky_title` | String | Override title |
+| `alt_text` | String | Alt text for images |
+
+Limits: 4 images max, 1MB per image, 50 uploads/day.
+
+## Common Parameters (All Platforms)
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `first_comment` | String | Auto-post first comment (Instagram, Facebook, Threads, Bluesky, Reddit, X, YouTube) |
+| `async_upload` | Boolean | Background processing |
+| `scheduled_date` | String | ISO-8601 schedule time |
+| `timezone` | String | IANA timezone for schedule |
--- a/references/requirements.md
+++ b/references/requirements.md
@@ -0,0 +1,127 @@
+# Media Requirements by Platform
+
+## Photo Requirements
+
+### Instagram
+- Formats: JPEG, PNG, GIF
+- Aspect ratio: 4:5 to 1.91:1
+- Recommended: 1080x1350px (4:5)
+
+### TikTok
+- Formats: JPG, JPEG, WEBP only
+- Use for photo slideshows with `auto_add_music`
+
+### Facebook
+- Formats: JPEG, PNG, GIF, WebP
+- Max size: 10MB recommended
+
+### X (Twitter)
+- Formats: JPEG, PNG, GIF
+- Max size: 5MB (images), 15MB (GIFs)
+- Max 4 images per tweet
+
+### LinkedIn
+- Formats: JPEG, PNG, GIF
+- Recommended: 1200x627px
+
+### Threads
+- Formats: JPEG, PNG
+- Max size: 8MB
+- Aspect ratio: 10:1 to 1:10
+- Width: 320px min, 1440px max
+- Color space: sRGB (auto-converted)
+
+### Pinterest
+- Formats: BMP, JPEG, PNG, TIFF, GIF, WebP
+- Max size: 20MB
+- Recommended: 1000x1500px (2:3)
+- Min: 600x900px, Max: 2000x3000px
+- Carousel: up to 5 images, same dimensions
+
+### Reddit
+- Formats: JPG, PNG, GIF, WEBP
+- Max size: 10MB
+
+### Bluesky
+- Formats: JPEG, PNG, GIF, WebP
+- Max size: 1MB per image
+- Max 4 images per post
+- Daily limit: 50 uploads (photos + videos)
+
+## Video Requirements
+
+### TikTok
+- Formats: MP4, MOV, WebM
+- Duration: 3s to 10min
+- Max size: 4GB
+- Recommended: 1080x1920 (9:16)
+- Codec: H.264
+
+### Instagram
+- Formats: MP4, MOV
+- Reels: 0-90s, 9:16 aspect
+- Feed: up to 60s
+- Max size: 4GB
+- Codec: H.264, AAC audio
+
+### YouTube
+- Formats: MP4, MOV, AVI, WMV, FLV, WebM
+- Max size: 256GB
+- Max duration: 12 hours
+- Recommended: 1920x1080 or 3840x2160
+
+### LinkedIn
+- Formats: MP4
+- Duration: 3s to 10min
+- Max size: 5GB
+- Aspect: 1:2.4 to 2.4:1
+
+### Facebook
+- Formats: MP4, MOV
+- Max size: 10GB
+- Max duration: 240min
+- Recommended: H.264, AAC
+
+### X (Twitter)
+- Formats: MP4, MOV
+- Max size: 512MB
+- Max duration: 140s (2min 20s)
+- Codec: H.264
+
+### Threads
+- Formats: MP4, MOV
+- Max duration: 5min
+- Aspect: 9:16 recommended
+
+### Pinterest
+- Formats: MP4, MOV, M4V
+- Duration: 4s to 15min
+- Max size: 2GB
+- Aspect: 1:2 to 1.91:1
+
+### Bluesky
+- Formats: MP4
+- Max size: 50MB
+- Max duration: 60s
+- Daily limit: 50 uploads
+
+## Document Requirements (LinkedIn only)
+
+- Formats: PDF, PPT, PPTX, DOC, DOCX
+- Max size: 100MB
+- Max pages: 300
+
+## FFmpeg Re-encoding
+
+If videos fail platform validation, use the FFmpeg endpoint:
+
+```bash
+# Convert to H.264 MP4
+ffmpeg -y -i {input} -c:v libx264 -preset medium -crf 23 -c:a aac -b:a 128k {output}
+
+# Resize to 1080p
+ffmpeg -y -i {input} -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -crf 23 {output}
+
+# Convert to 9:16 vertical
+ffmpeg -y -i {input} -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -crf 23 {output}
+```