# "Tạo tác vụ ideogram-ai/ideogram-v2-turbo"

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

> 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/ideogram-ai/ideogram-v2-turbo/predictions:
    post:
      summary: Tạo tác vụ ideogram-ai/ideogram-v2-turbo
      deprecated: false
      description: >-
        Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực
        tiếp nội dung từ URL đã cung cấp.
      operationId: replicate_replicate_v1_models_ideogram_ai_ideogram_v2_turbo_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. Bị bỏ qua nếu độ phân giải hoặc hình
                        ảnh sửa chữa được chỉ định. Giá trị mặc định: "1:1".
                    magic_prompt_option:
                      type: string
                      description: >-
                        Magic Prompt diễn giải các câu lệnh của bạn và tối ưu
                        hóa chúng để tăng tối đa sự đa dạng và chất lượng của
                        những hình ảnh tạo ra. Bạn cũng có thể dùng tính năng
                        này để viết câu lệnh bằng nhiều ngôn ngữ khác nhau. Giá
                        trị mặc định: "Tự động".
                    prompt:
                      type: string
                      description: Lời nhắc văn bản được tạo từ hình ảnh.
                    resolution:
                      type: string
                      description: >-
                        độ phân giải. Tỷ lệ khung hình phủ kín. Nếu một hình ảnh
                        sửa chữa được chỉ định, tham số này sẽ bị bỏ qua. Giá
                        trị mặc định: "Không có".
                    style_type:
                      type: string
                      description: >-
                        Phong cách giúp xác định diện mạo thẩm mỹ cụ thể của
                        hình ảnh bạn muốn tạo ra. Giá trị mặc định: "Không có".
                  description: Vui lòng cung cấp nội dung tài liệu cần dịch.
                  x-apifox-orders:
                    - aspect_ratio
                    - magic_prompt_option
                    - prompt
                    - resolution
                    - style_type
                  x-apidog-orders:
                    - aspect_ratio
                    - magic_prompt_option
                    - prompt
                    - resolution
                    - style_type
              x-apifox-orders:
                - input
              x-apidog-orders:
                - input
            examples:
              ideogram_aiideogram_v2_turbo_single:
                value:
                  input:
                    aspect_ratio: '1:1'
                    magic_prompt_option: Tự động
                    prompt: >-
                      Hình minh họa một chiếc giày chạy bộ màu vàng với dòng chữ
                      "Chạy AI bằng API" được viết trên giày. Chiếc giày được
                      đặt trên nền màu hồng. Dòng chữ có màu trắng và in đậm.
                      Tổng thể hình ảnh mang phong cách hiện đại, đậm chất công
                      nghệ, với các yếu tố gợi lên tốc độ.
                    resolution: Không có
                    style_type: Không có
                summary: ideogram_aiideogram_v2_turbo_single
                description: Tạo tác vụ ideogram-ai/ideogram-v2-turbo
      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: >-
                  PostReplicateV1ModelsIdeogramAiIdeogramV2TurboPredictionsResponse
                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-29T09:37:36.685Z'
                    data_removed: false
                    id: 2jycc2v9nnrmc0crap5tv5zaxr
                    input:
                      aspect_ratio: '1:1'
                      magic_prompt_option: Tự động
                      prompt: >-
                        Hình minh họa một chiếc giày chạy bộ màu vàng với dòng
                        chữ "Chạy AI bằng API" được viết trên giày. Chiếc giày
                        được đặt trên nền màu hồng. Dòng chữ có màu trắng và in
                        đậm. Tổng thể hình ảnh mang phong cách hiện đại, đậm
                        chất công nghệ, với các yếu tố gợi lên tốc độ.
                      resolution: Không có
                      style_type: Không có
                    logs: ''
                    model: ideogram-ai/ideogram-v2-turbo
                    status: starting
                    urls:
                      cancel: >-
                        https://api.replicate.com/v1/predictions/2jycc2v9nnrmc0crap5tv5zaxr/cancel
                      get: >-
                        https://api.replicate.com/v1/predictions/2jycc2v9nnrmc0crap5tv5zaxr
                      stream: >-
                        Vui lòng dán nội dung tài liệu vào đây để tôi dịch sang
                        tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh,
                        URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng.
                      web: https://replicate.com/p/2jycc2v9nnrmc0crap5tv5zaxr
                    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-45208968-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
