# "Tạo tác vụ recraft-ai/recraft-v3"

Nguồn: https://docs.openaihub.net/api-45208957/

> API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.


## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /replicate/v1/models/recraft-ai/recraft-v3/predictions:
    post:
      summary: Tạo tác vụ recraft-ai/recraft-v3
      deprecated: false
      description: 'Tài liệu chính thức: https://replicate.com/recraft-ai/recraft-v3'
      operationId: replicate_replicate_v1_models_recraft_ai_recraft_v3_predictions
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao
        - Tái tạo
      parameters:
        - name: Authorization
          in: header
          description: Khóa API Bearer
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  required:
                    - prompt
                  properties:
                    aspect_ratio:
                      type: string
                      description: >-
                        Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc
                        định: "Chưa thiết lập"
                    prompt:
                      type: string
                      description: Lời nhắc văn bản được tạo từ hình ảnh.
                    size:
                      type: string
                      description: >-
                        Tạo chiều rộng và chiều cao của hình ảnh. Nếu tỷ lệ
                        khung hình được thiết lập, các kích thước sẽ bị bỏ qua.
                        Giá trị mặc định: "1024x1024"
                    style:
                      type: string
                      description: >-
                        Phong cách của hình ảnh được tạo. Giá trị mặc định:
                        "any"
                  description: Vui lòng cung cấp nội dung tài liệu cần dịch.
                  x-apifox-orders:
                    - aspect_ratio
                    - prompt
                    - size
                    - style
                  x-apidog-orders:
                    - aspect_ratio
                    - prompt
                    - size
                    - style
              x-apifox-orders:
                - input
              x-apidog-orders:
                - input
            examples:
              recraft_airecraft_v3_single:
                value:
                  input:
                    aspect_ratio: Chưa đặt
                    prompt: >-
                      một bức ảnh động vật hoang dã chụp một chú gấu trúc đỏ
                      đang sử dụng máy tính xách tay trong khu rừng phủ đầy
                      tuyết
                    size: 1365x1024
                    style: bất kỳ
                summary: recraft_airecraft_v3_single
                description: Tạo tác vụ recraft-ai/recraft-v3
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - status
                properties:
                  created_at:
                    type: string
                    description: Thời gian tạo
                  data_removed:
                    type: boolean
                    description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa
                  error:
                    type: string
                    description: Thông báo lỗi
                    nullable: true
                  id:
                    type: string
                    description: ID tài nguyên hoặc tác vụ
                  input:
                    type: object
                    properties:
                      aspect_ratio:
                        type: string
                        description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1'
                      input_image:
                        type: string
                        description: URL hình ảnh đầu vào hoặc Base64
                      output_format:
                        type: string
                        description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp'
                      prompt:
                        type: string
                        description: Lời nhắc văn bản
                      prompt_upsampling:
                        type: boolean
                        description: Có tăng độ phân giải / cải thiện lời nhắc hay không
                      safety_tolerance:
                        type: integer
                        description: Mức dung sai của bộ lọc an toàn
                    description: Vui lòng cung cấp nội dung tài liệu cần dịch.
                    x-apifox-orders:
                      - aspect_ratio
                      - input_image
                      - output_format
                      - prompt
                      - prompt_upsampling
                      - safety_tolerance
                    x-apidog-orders:
                      - aspect_ratio
                      - input_image
                      - output_format
                      - prompt
                      - prompt_upsampling
                      - safety_tolerance
                  logs:
                    type: string
                    description: Nhật ký chạy
                  model:
                    type: string
                    description: Tên mô hình / mã định danh mô hình
                  output:
                    type: string
                    description: Kết quả đầu ra
                    nullable: true
                  status:
                    type: string
                    description: Trạng thái
                  urls:
                    type: object
                    required:
                      - cancel
                      - get
                      - stream
                      - web
                    properties:
                      cancel:
                        type: string
                        description: URL để hủy tác vụ
                      get:
                        type: string
                        description: URL để truy vấn trạng thái tác vụ
                      stream:
                        type: string
                        description: Có truyền phát phản hồi hay không
                      web:
                        type: string
                        description: URL để xem tác vụ trong trình duyệt
                    description: Danh sách URL tài nguyên
                    x-apifox-orders:
                      - cancel
                      - get
                      - stream
                      - web
                    x-apidog-orders:
                      - cancel
                      - get
                      - stream
                      - web
                  version:
                    type: string
                    description: Phiên bản
                refName: PostReplicateV1ModelsRecraftAiRecraftV3PredictionsResponse
                x-apifox-orders:
                  - created_at
                  - data_removed
                  - error
                  - id
                  - input
                  - logs
                  - model
                  - output
                  - status
                  - urls
                  - version
                x-apidog-orders:
                  - created_at
                  - data_removed
                  - error
                  - id
                  - input
                  - logs
                  - model
                  - output
                  - status
                  - urls
                  - version
              examples:
                example:
                  summary: example
                  value:
                    created_at: '2025-07-30T01:45:30.496Z'
                    data_removed: false
                    id: w5k77rccg1rma0crb40tssh86g
                    input:
                      aspect_ratio: Chưa đặt
                      prompt: >-
                        một bức ảnh động vật hoang dã chụp một chú gấu trúc đỏ
                        đang sử dụng máy tính xách tay trong khu rừng phủ đầy
                        tuyết
                      size: 1365x1024
                      style: bất kỳ
                    logs: ''
                    model: recraft-ai/recraft-v3
                    status: starting
                    urls:
                      cancel: >-
                        https://api.replicate.com/v1/predictions/w5k77rccg1rma0crb40tssh86g/cancel
                      get: >-
                        https://api.replicate.com/v1/predictions/w5k77rccg1rma0crb40tssh86g
                      stream: >-
                        Vui lòng truy xuất nội dung tại
                        https://stream.replicate.com/v1/files/bcwr-otkjt5aiey7d63eore5rhoezsvrxwsc5q6ow2x5lpqh3l6x33hgq
                        rồi dịch tài liệu kỹ thuật sang tiếng Việt. Giữ nguyên
                        Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ,
                        cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch
                        và không để lại ký tự Hán.
                      web: https://replicate.com/p/w5k77rccg1rma0crb40tssh86g
                    version: ẩn
          headers: {}
          x-apidog-name: ''
        '400':
          description: Yêu cầu không hợp lệ hoặc xác thực thất bại
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Yêu cầu không hợp lệ (mã yêu cầu:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
        '401':
          description: Khóa API bị thiếu hoặc không hợp lệ
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Mã thông báo không hợp lệ (request id:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208957-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
