Tổng quan Bắt đầu nhanh Xác thực Danh sách mô hình Tạo ảnh Sửa ảnh Tạo video Mô hình & giá Lỗi & giới hạn

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://api.fablemedical.shop/v1

Bắt đầu nhanh →Gọi thử trong 2 phút

Tạo ảnh →2 mô hình ảnh

Tạo video →2 mô hình video

Bắt đầu nhanh#

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

1Đăng nhập →
Bằng tài khoản Google.
2Nhận API key →
Nhắn chúng tôi để được cấp key.
3Nạp tiền →
Trả trước, dùng tới đâu trừ tới đó.

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

bash

export FABLEMEDICAL_API_KEY="sk-..."

bash

curl https://api.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"}'

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.

text

Authorization: Bearer sk-...
Content-Type: application/json

Giữ key ở server. Đừng nhúng vào web hay app phát hành — ai có key là dùng được tiền của bạn. Lộ key thì xoá ngay trong trang API key và nhắn chúng tôi để cấp key mới.

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

bash

curl https://api.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 base64 ở data[].b64_json (PNG).

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. Quyết định giá, xem bảng giá. Không gửi = mặc định.
sizestring1024x1024 (1K) hoặc 2048x2048 (2K). Quyết định giá. Không gửi = 1K.
aspect_ratiostringTỉ lệ khung: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1.

bash

curl https://api.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,
    "size": "2048x2048",
    "quality": "medium",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

Giá ảnh tính theo quality + size (tham số chuẩn OpenAI) — xem bảng giá. Trong SDK OpenAI, aspect_ratio đặt trong extra_body. Ảnh 2K có thể nặng ~8 MB, mất khoảng 20–30 giây.

Kết quả mẫu

grok-imagine-image-2.0Macro shot of a diamond ring on dark velvet, caustic light sparkles, luxury jewelry advertising

grok-imagine-image-2.0Vietnamese pho bowl with rising steam, fresh herbs and lime, dark wood table, moody food advertising photo

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 3 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 — quyết định giá.
aspect_ratiostringNhư tạo ảnh.

bash

curl https://api.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 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.

status	Nghĩa là
queued	Đã nhận, đang chờ.
in_progress	Đang tạo. Có progress từ 0 tới 100.
completed	Xong. Gọi /content để tải.
failed	Lỗi. Xem error.message.

bash

# 1. Tạo job, nhận về id
curl https://api.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://api.fablemedical.shop/v1/videos/$ID -H "Authorization: Bearer $FABLEMEDICAL_API_KEY"

# 3. Tải file MP4
curl https://api.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.

Mô hình & giá#

Ảnh tính theo số ảnh, video theo số giây và độ phân giải. Cần giá sỉ theo khối lượng? Nhắn Telegram.

Mô hình	Loại	Giá từ	Độ phân giải	Chất lượng	Tỉ lệ khung	Đầu vào
grok-imagine-video-1.5Video điện ảnh tới 1080p, chuyển động mượt.	Video	2.080đ / giây	480p720p1080p	—	7 tỉ lệ	1–15 giây · chữ hoặc ảnh
grok-imagine-videoVideo ngắn 480p / 720p, kèm âm thanh.	Video	1.300đ / giây	480p720p	—	7 tỉ lệ	1–15 giây · chữ hoặc ảnh
grok-imagine-image-2.0Ảnh chất lượng cao, nhiều chi tiết hơn.	Ảnh	1.040đ / ảnh	1K2K	lowmedium	13 tỉ lệ	chữ + tối đa 3 ảnh
grok-imagine-imageẢnh nhanh, rẻ. Hợp thử ý tưởng và ảnh mạng xã hội.	Ảnh	520đ / ảnh	—	—	—	—

grok-imagine-video-1.5

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

từ 2.080đ / giây

Độ phân giải	Mỗi giây	Clip 5 giây	Clip 10 giây	Clip 15 giây
480p	2.080đ	10.400đ	20.800đ	31.200đ
720p	3.640đ	18.200đ	36.400đ	54.600đ
1080p	6.490đ	32.450đ	64.900đ	97.350đ

Chọn mức giá: gửi extra_body.resolution (480p / 720p / 1080p) và seconds. Tiền = giá mỗi giây × số giây.
Thời lượng: 1–15 giây mỗi clip, có âm thanh
Tỉ lệ khung (7): 16:99:161:14:33:43:22:3
Ảnh → video: Gửi ảnh làm khung hình đầu, không tính thêm phí.

grok-imagine-video

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

từ 1.300đ / giây

Độ phân giải	Mỗi giây	Clip 5 giây	Clip 10 giây	Clip 15 giây
480p	1.300đ	6.500đ	13.000đ	19.500đ
720p	1.820đ	9.100đ	18.200đ	27.300đ

Chọn mức giá: gửi extra_body.resolution (480p / 720p) và seconds. Tiền = giá mỗi giây × số giây.
Thời lượng: 1–15 giây mỗi clip, có âm thanh
Tỉ lệ khung (7): 16:99:161:14:33:43:22:3
Ảnh → video: Gửi ảnh làm khung hình đầu, không tính thêm phí.

grok-imagine-image-2.0

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

từ 1.040đ / ảnh

Chất lượng \ Độ phân giải	1K 1024x1024	2K 2048x2048
Nhanh (low)	1.040đ	1.560đ
Tiêu chuẩn (medium)	mặc định1.560đ	2.080đ

Chọn mức giá: gửi quality (low / medium) và size (1024x1024 / 2048x2048). Không gửi = mức mặc định.
Tỉ lệ khung (13): 1:13:44:39:1616:92:33:29:19.519.5:99:2020:91:22:1
Sửa / ghép ảnh: Tối đa 3 ảnh tham chiếu mỗi lần, không tính thêm phí.
Ví dụ (mặc định): 10 ảnh ≈ 15.600đ100 ảnh ≈ 156.000đ1.000 ảnh ≈ 1.560.000đ

grok-imagine-image

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

từ 520đ / ảnh

520đ / ảnh, mọi kích thước

Sửa / ghép ảnh: Có hỗ trợ sửa ảnh có sẵn.
Ví dụ (mặc định): 10 ảnh ≈ 5.200đ100 ảnh ≈ 52.000đ1.000 ảnh ≈ 520.000đ

Video

grok-imagine-video-1.5

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

480p: 2.080đ / giây
720p: 3.640đ / giây
1080p: 6.490đ / giây

Video

grok-imagine-video

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

480p: 1.300đ / giây
720p: 1.820đ / giây

Ảnh

grok-imagine-image-2.0

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

Mỗi ảnh: 1.560đ / ảnh

Ảnh

grok-imagine-image

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

Mỗi ảnh: 520đ / ảnh

Lỗi & giới hạn#

Mã	Lý do	Cách xử lý
400	Tham số sai, hoặc hết số dư.	Kiểm tra body. Hết tiền thì nạp thêm.
401	Thiếu key hoặc key sai.	Kiểm tra header Authorization.
404	Sai model hoặc id video.	Lấy id đúng từ GET /models.
429	Gọi quá nhanh.	Chờ vài giây rồi thử lại.
5xx	Má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.
✓Chi phí trừ vào số dư ngay khi request thành công.

Sẵn sàng?Nhận API key →Cần hỗ trợ tích hợp?Chat qua Telegram →