AI APIAPI

Viết bằng AI, theo đúng cách bạn sẽ thực sự gọi nó

Một endpoint REST tạo chú thích từ một bản tóm tắt yêu cầu. Phần còn lại của bộ công cụ viết, gồm viết lại bản nháp cho từng mạng và tái sử dụng nội dung từ URL, nằm trên máy chủ MCP của FoPost, nơi AI client có thể nối thẳng vào bước lên lịch.

POST /v1/ai/generate-caption
curl -X POST https://api.fopost.com/v1/ai/generate-caption \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "instructions": "Announce webhook retries with exponential backoff. Keep it direct.",
    "platforms": ["linkedin"]
  }'

Một endpoint REST

generate-caption nhận bản tóm tắt yêu cầu và các nền tảng đích, rồi trả về nội dung sẵn dùng.

Ba công cụ MCP

generate_caption, rewrite_for_platforms và repurpose_url cho mọi MCP client.

Tính theo tín dụng

Mỗi lệnh gọi trừ vào tín dụng AI của không gian làm việc. Xem số dư bất cứ lúc nào.

REST

Tạo chú thích từ quy trình của riêng bạn

Gửi một bản tóm tắt ngắn và mạng đích, nhận lại chú thích viết trong giới hạn của mạng đó. Khóa cần có phạm vi ai. Phản hồi là văn bản; không có gì được đăng cho đến khi bạn tự truyền nó vào POST /v1/posts.

Đọc tài liệu tham khảo về AI
Phản hồi
{
  "caption": "Webhook retries are live. A failed delivery now retries with exponential backoff before it ever reaches your inbox as an error. Details in the changelog.",
  "credits": { "charged": 1, "remaining": 199 }
}

Hiểu từng nền tảng

Độ dài, cách dùng hashtag và ngắt dòng theo đúng mạng bạn chỉ định.

Không bao giờ tự đăng

Endpoint trả về văn bản. Đăng bài là một yêu cầu riêng, rõ ràng.

Phạm vi ai

Chỉ cấp cho những khóa được phép tiêu tín dụng.

MCP

Viết lại và tái sử dụng nội dung từ AI client

Máy chủ MCP cung cấp đầy đủ bộ công cụ viết. rewrite_for_platforms biến một bản nháp thành chuỗi bài cho X và một đoạn văn cho LinkedIn. repurpose_url đọc một trang và đề xuất loạt bài đăng. Cả hai đều chuyển kết quả cho schedule_post trong cùng phiên, và client luôn hỏi trước khi bất cứ thứ gì được đăng.

Thiết lập máy chủ MCP
Prompt
> Take our latest changelog at https://yourbrand.com/changelog
  and turn it into three posts for LinkedIn and X this week.

Agent: I'll call repurpose_url, then rewrite_for_platforms for each,
then schedule_post for Tue, Wed, and Thu at 9am. Proceed? (y/n)

rewrite_for_platforms

Đưa vào một bản nháp, nhận lại mỗi mạng một phiên bản, đều nằm trong giới hạn.

repurpose_url

Chỉ nó đến một bài viết, changelog hoặc trang tài liệu và nhận lại một loạt bài.

Chuyển thẳng sang lên lịch

Agent nối các công cụ viết vào schedule_post mà không cần rời khỏi cuộc trò chuyện.

Tín dụng

Chi tiêu minh bạch, có giới hạn và theo từng không gian làm việc

Mọi lệnh gọi AI được tính vào tín dụng sử dụng miễn phí hàng tháng có trong mọi tài khoản. Xem số dư qua MCP bằng get_ai_credits, và trong bảng điều khiển ở mục AI Usage. Khi hết số dư, lệnh gọi trả về 402 kèm liên kết nâng cấp thay vì thất bại âm thầm.

Bắt đầu xây dựng
Agent đang soạn bài đăng cho nhiều mạng theo giọng thương hiệu đã lưu

get_ai_credits

Hỏi agent còn bao nhiêu tín dụng trước một đợt lớn.

Lỗi 402 rõ ràng

Hết số dư là một lỗi rõ ràng, không bao giờ là một bài viết dở dang.

Giới hạn trong không gian làm việc

Tín dụng và prompt nằm gọn trong không gian làm việc mà khóa thuộc về.

Giải đáp câu hỏi về AI API

Những tính năng AI nào có trên REST API?

Một endpoint: POST /v1/ai/generate-caption, với phạm vi ai. Viết lại cho từng mạng, gợi ý hashtag và tái sử dụng nội dung từ URL hiện có dưới dạng công cụ MCP và trong agent của ứng dụng, chưa phải là endpoint REST công khai.

Nó dùng mô hình nào?

FoPost không công khai nhà cung cấp hay mô hình. Bạn chọn tính năng và giọng điệu; dịch vụ chọn thứ chạy nó và có thể thay đổi mà bạn không cần sửa gì.

Nó có tự đăng bài không?

Không. Mọi endpoint và công cụ AI đều trả về văn bản. Đăng bài là một yêu cầu riêng, và MCP client hiển thị lệnh gọi schedule_post để bạn duyệt trước khi chạy.

Tín dụng được tính như thế nào?

Mỗi lệnh gọi được tính vào tài khoản thanh toán của bạn và trả về cùng phản hồi. Mức sử dụng trừ vào tín dụng miễn phí hàng tháng trước; khi đã lưu thẻ, phần vượt quá được tính đúng theo mức bạn dùng.

Nó có biết giọng thương hiệu của tôi không?

Lệnh gọi từ agent trong ứng dụng có thể đính kèm một thương hiệu, đưa giọng văn và phong cách của nó vào prompt. Endpoint REST nhận brand_voice_id, hoặc dùng thương hiệu mặc định của không gian làm việc, cùng với bản tóm tắt bạn gửi.

Khóa cần phạm vi nào?

Phạm vi ai. Khóa không có phạm vi này nhận lỗi 403 ở endpoint này, nhưng vẫn hoạt động với các phạm vi khác mà nó có.

Xây dựng trên AI API ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API