Tài liệu / Tổng quan

Tài liệu API

Tạo ảnh, sửa ảnh, làm video bằng một API key. Chuẩn OpenAI: đổi base_url là chạy.

Base URLhttps://fablemedical.shop/v1

Bắt đầu nhanh#

Ba bước là có ảnh đầu tiên.

  1. 1Đăng nhập →

    Bằng tài khoản Google.

  2. 2Nạp tiền →

    Quét QR, tiền vào ví sau vài giây.

  3. 3Mua gói →

    Chọn số luồng, nhận API key ngay.

Lưu key vào biến môi trường rồi gọi thử:

export FABLEMEDICAL_API_KEY="fm-..."
curl https://fablemedical.shop/v1/images/generations \ -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "grok-imagine-image-2.0", "prompt": "Luxury perfume bottle on black obsidian rock, golden splash, studio light"}'
Luxury perfume bottle on black obsidian rock, golden liquid splash frozen mid-air, dramatic studio lighting, high-end commercial product photography
Kết quả mẫu · grok-imagine-image-2.0Luxury perfume bottle on black obsidian rock, golden liquid splash frozen mid-air, dramatic studio lighting, high-end commercial product photography

Xác thực#

Mọi request gửi kèm API key trong header.

Authorization: Bearer fm-... Content-Type: application/json
  • Mỗi gói có một API key fm-…, nhận ngay khi mua ở trang Gói & API key.
  • Key chỉ hiện đầy đủ một lần. Chép và cất ngay. Quên thì bấm Đổi key để lấy key mới.
  • Gói hết hạn: API trả 402. Gia hạn là key chạy lại ngay, không đổi key.
Giữ key ở server. Đừng nhúng vào web hay app phát hành — ai có key là dùng được gói của bạn. Lộ key thì bấm Đổi key ngay trong trang Gói & API key.

Danh sách mô hình#

Các mô hình key của bạn gọi được. Lấy id ở đây để truyền vào model.

GET/v1/models

curl https://fablemedical.shop/v1/models -H "Authorization: Bearer $FABLEMEDICAL_API_KEY"

Tạo ảnh#

Viết mô tả, nhận ảnh. Ảnh trả về dạng link ở data[].url, link sống khoảng 1 giờ — tải về lưu ngay.

POST/v1/images/generations

Tham số
  • modelstringbắt buộcgrok-imagine-image-2.0 hoặc grok-imagine-image.
  • promptstringbắt buộcMô tả ảnh. Tiếng Anh cho kết quả ổn định nhất.
  • nintegerSố ảnh cần tạo. Mặc định 1.
  • qualitystringlow hoặc medium, hoặc auto.
  • resolutionstring1k hoặc 2k.
  • aspect_ratiostringTỉ lệ khung: 1:1, 16:9, 9:16, 4:3, 3:4, 20:9, 9:19.5, auto.
curl https://fablemedical.shop/v1/images/generations \ -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-image-2.0", "prompt": "Luxury perfume bottle on black obsidian rock, golden splash, studio light", "n": 1, "quality": "medium", "resolution": "2k", "aspect_ratio": "16:9" }'
Trong SDK OpenAI, resolution và aspect_ratio đặt trong extra_body. Ảnh 2K có thể nặng ~8 MB, mất khoảng 20–30 giây — mỗi request chiếm một luồng tới khi trả về.

Kết quả mẫu

Macro shot of a diamond ring on dark velvet, caustic light sparkles, luxury jewelry advertising
grok-imagine-image-2.0Macro shot of a diamond ring on dark velvet, caustic light sparkles, luxury jewelry advertising
Vietnamese pho bowl with rising steam, fresh herbs and lime, dark wood table, moody food advertising photo
grok-imagine-image-2.0Vietnamese pho bowl with rising steam, fresh herbs and lime, dark wood table, moody food advertising photo
Anime illustration, a girl on a rooftop at sunset over a Vietnamese city, paper lanterns, glowing clouds, painterly Makoto Shinkai style
grok-imagine-image-2.0Anime illustration, a girl on a rooftop at sunset over a Vietnamese city, paper lanterns, glowing clouds, painterly Makoto Shinkai style

Sửa ảnh#

Gửi ảnh gốc kèm yêu cầu sửa, dạng multipart/form-data. Ghép tới 5 ảnh, gọi tên theo thứ tự gửi: <IMAGE_0>, <IMAGE_1>…

POST/v1/images/edits

Tham số
  • imagefilebắt buộcJPEG, PNG hoặc WebP. Lặp lại field tối đa 5 lần.
  • promptstringbắt buộcMuốn sửa gì. Phần còn lại được giữ nguyên.
  • modelstringbắt buộcgrok-imagine-image-2.0 hoặc grok-imagine-image.
  • quality / sizestringNhư tạo ảnh.
  • aspect_ratiostringNhư tạo ảnh.
curl https://fablemedical.shop/v1/images/edits \ -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" \ -F "model=grok-imagine-image-2.0" \ -F "prompt=Đổi nền thành bãi biển lúc hoàng hôn" \ -F "image=@photo.png"
Chưa hỗ trợ mask. Mô tả vùng cần sửa ngay trong prompt.

Tạo video#

Video chạy nền: tạo job → hỏi trạng thái → tải MP4. Clip 720p thường xong trong khoảng 1 phút, có sẵn âm thanh.

POST/v1/videos

GET/v1/videos/{id}

GET/v1/videos/{id}/content

Tham số
  • modelstringbắt buộcgrok-imagine-video-1.5, grok-imagine-video-1.5-lite hoặc grok-imagine-video.
  • promptstringbắt buộcMô tả cảnh và chuyển động máy quay.
  • secondsstringĐộ dài 1–15 giây, truyền dạng chuỗi. Mặc định "8".
  • image{ url }Ảnh đầu vào (URL công khai hoặc data URI) để biến ảnh thành video.
  • extra_body.resolutionstringĐộ phân giải: 480p, 720p, 1080p.
  • extra_body.aspect_ratiostring16:9, 9:16, 1:1… Mặc định 16:9.
  • extra_body.last_frame{ url }Chốt khung hình cuối. Dùng cùng ảnh với image để có clip lặp liền mạch.
statusNghĩa là
queuedĐã nhận, đang chờ.
in_progressĐang tạo. Có progress từ 0 tới 100.
completedXong. Gọi /content để tải (trả 302 về link file, sống khoảng 1 giờ — curl cần -L).
failedLỗi. Xem error.message.
# 1. Tạo job, nhận về id curl https://fablemedical.shop/v1/videos \ -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-video-1.5", "prompt": "Slow motion golden splash around a perfume bottle", "seconds": "8", "extra_body": { "resolution": "720p", "aspect_ratio": "16:9" } }' # 2. Hỏi trạng thái vài giây một lần, tới khi "completed" curl https://fablemedical.shop/v1/videos/$ID -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" # 3. Tải file MP4 curl -L https://fablemedical.shop/v1/videos/$ID/content -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" -o clip.mp4
File chỉ lưu một thời gian. Tải về ngay khi job completed.

Kết quả mẫu

grok-imagine-video-1.5 · 720pSlow motion. Golden liquid splashes and swirls around the perfume bottle, camera slowly orbits, sparkles.
grok-imagine-video-1.5 · 720pSlow camera push-in. Rain falls, motorbikes pass leaving light trails, neon signs flicker, puddles ripple.

Sửa & nối video#

Sửa clip đã tạo: POST /videos/edits với { video: { id }, prompt }. Nối dài: POST /videos/extensions với video.id, prompt, seconds 2–10. Chỉ dùng cho clip của grok-imagine-video.

POST/v1/videos/edits

POST/v1/videos/extensions

curl https://fablemedical.shop/v1/videos/edits -H "Authorization: Bearer $FABLEMEDICAL_API_KEY" -H "Content-Type: application/json" -d '{ "video": { "id": "video_abc123" }, "prompt": "Đổi trời thành có tuyết rơi" }'

Mô hình & gói#

Một gói dùng được mọi mô hình dưới đây, không giới hạn số lượt. Cần nhiều luồng? Nhắn Telegram.

Gói Grok không giới hạn

Số ngày (tối đa 1 tuần)

1 luồng

441.000đ/ 1 tuần

  • ✓Tới 10.080 video
  • ✓hoặc 20.160 ảnh
  • ✓1 việc chạy cùng lúc
2 luồngPhổ biến

882.000đ/ 1 tuần

  • ✓Tới 20.160 video
  • ✓hoặc 40.320 ảnh
  • ✓2 việc chạy cùng lúc
3 luồng

1.323.000đ/ 1 tuần

  • ✓Tới 30.240 video
  • ✓hoặc 60.480 ảnh
  • ✓3 việc chạy cùng lúc

4.410.000đ/ 1 tuần

  • ✓Tới 100.800 video
  • ✓hoặc 201.600 ảnh
  • ✓10 việc chạy cùng lúc

Ảnh + video · Hiện còn trống tối đa 43 luồng · Số video / ảnh là ước tính khi luồng chạy liên tục: video ~1 phút, ảnh ~30 giây.

  • ✓Gọi ảnh & video Grok không giới hạn
  • ✓1 luồng = 1 request chạy cùng lúc
  • ✓Chọn 1–7 ngày, gia hạn hoặc nâng cấp luồng bất cứ lúc nào
  • ✓Huỷ sớm: hoàn tiền phần chưa dùng
grok-imagine-image-2.0grok-imagine-imagegrok-imagine-video-1.5grok-imagine-video-1.5-litegrok-imagine-video

Luồng là gì?

1 luồng = 1 việc tạo ảnh hoặc video đang chạy. Ảnh và video dùng chung luồng.

  • Có 1 luồng, đang tạo ảnh thì phải chờ ảnh xong mới tạo được ảnh hay video khác.
  • Video cũng vậy: luồng chỉ được trả khi bạn hỏi trạng thái thấy video đã xong.
  • Không hỏi trạng thái thì sau 5 phút luồng mới tự được trả.
  • Muốn chạy nhiều việc cùng lúc? Mua thêm luồng.
Mỗi luồng = một việc tạo ảnh hoặc video chạy cùng lúc (ảnh và video dùng chung luồng). Ảnh trả luồng ngay khi xong. Video giữ luồng tới khi bạn hỏi trạng thái thấy đã xong; không hỏi thì sau 5 phút luồng mới được trả. Hỏi trạng thái và tải video không chiếm thêm luồng.
Ảnh
grok-imagine-image-2.0

Ảnh chất lượng cao, nhiều chi tiết hơn.

1k2k
Ảnh
grok-imagine-image

Ảnh nhanh, rẻ. Hợp thử ý tưởng và ảnh mạng xã hội.

1k
Video
grok-imagine-video-1.5

Video điện ảnh tới 1080p, chuyển động mượt.

480p720p1080p
Video
grok-imagine-video-1.5-lite

Bản nhẹ của Video 1.5, tới 1080p, rẻ hơn nhiều.

480p720p1080p
Video
grok-imagine-video

Video ngắn 480p / 720p, kèm âm thanh.

480p720p

Lỗi & giới hạn#

MãLý doCách xử lý
400Tham số sai.Đọc error.message, sửa body.
401Thiếu key hoặc key sai.Kiểm tra header Authorization.
402Gói đã hết hạn.Gia hạn gói trong dashboard.
404Sai model hoặc id video.Lấy id đúng từ GET /models.
429Đã dùng hết số luồng.Chờ request đang chạy xong, hoặc tăng số luồng.
5xxMáy chủ đang bận.Thử lại sau. Kéo dài thì báo hỗ trợ.
  • ✓Sửa ảnh: tối đa 5 ảnh đầu vào mỗi request.
  • ✓Video: 1–15 giây mỗi clip.
  • ✓Body tối đa 32 MB.
  • ✓Không giới hạn số lượt — chỉ giới hạn số request chạy cùng lúc.