跳至内容
API 参考函数ImageResponse

ImageResponse

ImageResponse 构造函数允许您使用 JSX 和 CSS 生成动态图像。这对于生成社交媒体图像(例如 Open Graph 图像、Twitter 卡片等)非常有用。

以下选项可用于 ImageResponse

import { ImageResponse } from 'next/og'
 
new ImageResponse(
  element: ReactElement,
  options: {
    width?: number = 1200
    height?: number = 630
    emoji?: 'twemoji' | 'blobmoji' | 'noto' | 'openmoji' = 'twemoji',
    fonts?: {
      name: string,
      data: ArrayBuffer,
      weight: number,
      style: 'normal' | 'italic'
    }[]
    debug?: boolean = false
 
    // Options that will be passed to the HTTP response
    status?: number = 200
    statusText?: string
    headers?: Record<string, string>
  },
)

支持的 CSS 属性

请参阅 Satori 的文档 以获取支持的 HTML 和 CSS 功能列表。

版本历史

版本更改
v14.0.0ImageResponsenext/server 移动到 next/og
v13.3.0可以从 next/server 导入 ImageResponse
v13.0.0通过 @vercel/og 包引入 ImageResponse