sangtao.ai
API key

Đăng bài

Nền chữ Facebook

Các nền cho bài chữ Facebook — dùng cho textFormatPresetId.

GEThttps://api.sangtao.ai/v2/publishing/facebook/text-presets

Xác thực

Không cần — endpoint này công khai, gọi không cần API key.

Các nền màu, gradient và nền hình mà Facebook cho dùng với bài chữ (status nền màu). Không cần key, không tốn credit. Gửi id của một nền làm platforms[].textFormatPresetId ở Đăng bài — với bài chỉ có chữ trên Facebook (không có jobId, videoUrl, imageUrls). Có ảnh hoặc video thì Facebook bỏ nền; nền tảng khác bỏ qua.

Danh sách do Facebook quản lý và có thể đổi bất cứ lúc nào — hãy gọi lấy, đừng ghi cứng ID. Danh sách được cache 6 giờ. ID không tồn tại vẫn được nhận khi đăng, nhưng bài sẽ thất bại trên Facebook.

Response

  • presetsobject[]bắt buộc

    Các nền. Rỗng khi tạm thời không lấy được danh sách

    Hiện thuộc tính con

    • idstringbắt buộc

      Gửi làm platforms[].textFormatPresetId ở Đăng bài

    • labelstringbắt buộc

      Tên nền, tiếng Anh, do Facebook đặt

    • kindstringbắt buộc

      Loại nền: màu đơn, gradient, hoặc nền hình

      Giá trị có thể:colorgradientillustration

    • colorstring | null

      Giá trị CSS dùng thẳng để vẽ ô xem trước: rgb(…) với color, linear-gradient(…) với gradient. Loại nào cũng có thể là null — Facebook chỉ cho màu của vài nền, nền hình thì không bao giờ có — nên khi null hãy vẽ ô trống (hoặc chỉ hiện label)

Nếu tạm thời không lấy được danh sách, bạn vẫn nhận 200 với presets: [] — đăng không có nền, hoặc thử lại sau.

GET/publishing/facebook/text-presets
curl "https://api.sangtao.ai/v2/publishing/facebook/text-presets"
{
  "success": true,
  "data": {
    "presets": [
      {
        "id": "1881421442117417",
        "label": "Black",
        "kind": "color",
        "color": "rgb(0, 0, 0)"
      },
      {
        "id": "433967226963128",
        "label": "Purple 2",
        "kind": "color",
        "color": null
      },
      {
        "id": "249307305544279",
        "label": "Red to blue gradient",
        "kind": "gradient",
        "color": "linear-gradient(45deg, rgb(255, 0, 71), rgb(44, 52, 199))"
      },
      {
        "id": "200521337465306",
        "label": "Flame emojis",
        "kind": "illustration",
        "color": null
      }
    ]
  }
}